VibeFox Cargoson for WooCommerce — Помощь

Требования

WordPress: 5.8 или новее.

WooCommerce: 5.0 или новее, установлен и активен. Без него плагин не активируется.

PHP: 8.0 или новее.

Аккаунт Cargoson (только для тарифов в реальном времени): тарифы в реальном времени используют API тарифов на перевозку Cargoson. Запросы тарифов на перевозку требуют подписки Cargoson с доступом к API (на момент написания — тариф Advanced или выше). Ключ API выдаётся в вашем аккаунте Cargoson; если в вашем тарифе нет настроек API, обратитесь в поддержку Cargoson. Тарифы поступают от перевозчиков и прайс-листов, подключённых к этому аккаунту. Если вы используете только фиксированные цены, аккаунт Cargoson не нужен.

Лицензионный ключ VibeFox: покупается на vibefox.net. Один ключ работает на одном домене.

Установка

1. В WordPress перейдите в Plugins > Add New > Upload Plugin, выберите ZIP-файл плагина и нажмите Install Now. Также можно загрузить папку vfd_cargoson в /wp-content/plugins/ по FTP.

2. Нажмите Activate.

3. Откройте настройки: WooCommerce > Settings > Shipping > VibeFox Cargoson или нажмите Settings под названием плагина на странице Plugins.

4. Введите лицензионный ключ VibeFox в блоке лицензии вверху страницы и нажмите Activate.

5. Выберите способ расчёта стоимости доставки и заполните соответствующие разделы: фиксированные цены и, для тарифов в реальном времени, ключ API и почтовый индекс отправки (см. Настройка).

6. Добавьте VibeFox Cargoson в зону доставки в WooCommerce > Settings > Shipping > Shipping zones или включите Ignore shipping zones и выберите страны.

Настройка

Все настройки находятся на одной странице: WooCommerce > Settings > Shipping > VibeFox Cargoson. Они действуют для всех зон доставки. Когда вы добавляете метод в зону, в окне зоны есть только одно поле:

Title (zone): название, которое покупатель видит для этой зоны. Оставьте поле пустым, чтобы использовать общий Method title.

Каждый раз при сохранении настроек кэшированные тарифы Cargoson очищаются. Дробные числа можно вводить через точку или запятую.

General

Enable/Disable: включает или выключает метод сразу во всех зонах.

Method title: название способа доставки, которое показывается в корзине и при оформлении заказа. По умолчанию: Cargoson. Зона может переопределить его.

Shipping cost: способ расчёта цены.

Причина отсутствия тарифа в реальном времени записывается в журнал WooCommerce. Покупателю она никогда не показывается.

Cargoson API (обязательно только для тарифов в реальном времени)

API key: ключ API из вашего аккаунта Cargoson. Он отправляется только на cargoson.com и никогда не показывается покупателям и не записывается в журнал.

Carrier: какие тарифы используются. Покупатель видит один тариф.

Package type code: код типа упаковки Cargoson, который отправляется с запросом тарифа. По умолчанию: CLL. В примерах API Cargoson используются EUR (европоддон EUR) и FIN (финский поддон FIN). Для посылок используйте код упаковки вашего аккаунта Cargoson. Заказ отправляется как одна упаковка с общим весом корзины.

Price currency: валюта тарифов в вашем аккаунте Cargoson в виде трёхбуквенного кода. По умолчанию: EUR. API возвращает суммы без кода валюты.

Currency conversion rate: нужен только если валюта тарифов отличается от валюты магазина: 1 единица валюты Cargoson = X единиц валюты магазина. Оставьте поле пустым, чтобы отклонять такие тарифы, и покупатель никогда не заплатит в неверной валюте.

Ship from (collection address) (используется для тарифов в реальном времени)

Collection country: страна, из которой вы отправляете. По умолчанию — страна вашего магазина.

Collection postcode: почтовый индекс, из которого вы отправляете. Cargoson требует его. Если поле пустое, а страна отправки совпадает со страной магазина, используется почтовый индекс магазина из WooCommerce > Settings > General.

Дата забора, которая отправляется в Cargoson, — сегодня или ближайший понедельник, если сегодня выходной.

Fixed prices (используется, когда Shipping cost установлен в Fixed prices, а также как запасной вариант для тарифов в реальном времени)

Price per country and size: таблица стран с колонкой Price и ценами по весу корзины в валюте магазина: XS до 1 кг, S до 2 кг, M до 3 кг, L до 5 кг, XL свыше 5 кг. Пустая цена размера или 0 использует колонку Price; пустая колонка Price означает, что для этого размера фиксированного тарифа нет. Нажмите Add country, чтобы добавить строку, и крестик, чтобы удалить её. Строка * Default применяется ко всем странам, у которых нет собственной строки. Страны без строки (если строки * нет) не получают фиксированного тарифа, поэтому метод для них скрыт.

Fixed price applies: Per order берёт цену один раз. Per item (price × quantity) умножает её на количество товаров в корзине. Тарифы Cargoson в реальном времени всегда начисляются за отправление.

Conditions

Minimum weight (kg): скрывает метод при весе корзины ниже этого значения. 0 означает без ограничения.

Maximum weight (kg): скрывает метод при весе корзины выше этого значения. По умолчанию: 25. 0 означает без ограничения.

Minimum order amount: показывает метод только тогда, когда промежуточный итог корзины (после скидок, до налогов) не меньше этой суммы. Оставьте поле пустым, чтобы показывать метод всегда.

Excluded shipping classes: скрывает метод, если в корзине есть товар из любого из этих классов доставки WooCommerce.

Free shipping: включает бесплатную доставку при достижении суммы заказа, указанной ниже.

Free shipping from: промежуточный итог корзины (после скидок, до налогов), начиная с которого доставка бесплатна. Используется только когда включена опция Free shipping.

Tax status: Taxable добавляет налог на доставку согласно налоговым настройкам WooCommerce, None — не добавляет. Тарифы перевозчиков в Cargoson обычно указаны без НДС. Выберите None, если ваши цены уже включают налог.

Availability without shipping zones

Ignore shipping zones: предлагает Cargoson для указанных ниже стран, даже если он не добавлен в зону доставки.

Countries: страны назначения для этого режима. Оставьте пустым, чтобы использовать все страны, в которые вы доставляете. Это поле используется только когда включена опция Ignore shipping zones.

Advanced

Debug log: записывает каждый расчёт тарифа в WooCommerce > Status > Logs, источник vfd_cargoson. Ошибки API записываются всегда, даже когда эта опция выключена. Ключ API и почтовый индекс покупателя никогда не записываются в журнал.

Remove data on uninstall: если включено, при удалении плагина удаляются все настройки Cargoson, методы зон и кэшированные тарифы. Деактивация плагина ничего не удаляет.

Как это работает при оформлении заказа

Когда покупатель вводит адрес доставки, WooCommerce запрашивает у плагина тариф. Сначала плагин проверяет условия: страна доставки, вес корзины, минимальная сумма заказа и исключённые классы доставки. Если применяется бесплатная доставка, покупатель получает бесплатный тариф, и запрос в Cargoson не отправляется.

В режиме фиксированных цен цена берётся из таблицы. В режимах тарифов в реальном времени плагин отправляет в Cargoson дату забора, страну и почтовый индекс отправки, страну и почтовый индекс доставки, а также одну упаковку с кодом типа упаковки и общим весом корзины (не менее 0,1 кг). Веса товаров переводятся из единиц вашего магазина в килограммы. Тариф в реальном времени запрашивается только после того, как покупатель ввёл почтовый индекс. Cargoson возвращает тарифы ваших перевозчиков; плагин выбирает самый дешёвый (среди выбранного перевозчика, если он задан) и при необходимости пересчитывает его в валюту магазина.

Каждый ответ кэшируется на 1 час, поэтому для той же корзины новый запрос не отправляется. Неудачный запрос кэшируется на 10 минут, чтобы оформление заказа не ждало Cargoson при каждом обновлении. Тайм-аут API составляет 10 секунд. Если Cargoson возвращает ошибку, не находит тариф для маршрута или возвращает цену в другой валюте без курса пересчёта, покупатель не видит никакой ошибки. Метод скрывается либо, в режиме с запасным вариантом, используется фиксированная цена.

Метод работает в классическом оформлении заказа и в блоках «Корзина» и «Оформление заказа». Он совместим с WooCommerce High-Performance Order Storage (HPOS).

Плагин только рассчитывает тарифы. Он не создаёт отправления или заявки в Cargoson, не печатает этикетки и не отслеживает посылки, а покупатели не могут выбрать постамат или пункт выдачи. Корзина рассчитывается как одна упаковка с общим весом; размеры упаковки не передаются. Показывается только самый дешёвый тариф, а не список перевозчиков.

Заказы

Когда используется тариф в реальном времени, в строке доставки заказа сохраняются назначенные Carrier, Service и Cargoson service ID. Они отображаются на экране редактирования заказа, чтобы вы знали, что бронировать в Cargoson. Оформите отправку в Cargoson или через его собственные интеграции.

Лицензионный ключ

Плагин работает с лицензионным ключом VibeFox с vibefox.net. Блок лицензии находится вверху страницы WooCommerce > Settings > Shipping > VibeFox Cargoson. Вставьте ключ в поле License key и нажмите Activate. В блоке отображается статус, например дата, до которой действует лицензия, и ваш домен. Кнопка Check now повторно проверяет статус, Change key позволяет ввести другой ключ, а Remove key удаляет ключ с этого сайта. Ссылка Manage licenses and domains in your account открывает ваш аккаунт на vibefox.net.

Один ключ работает на одном домене. Удаление ключа с сайта не освобождает место под домен. Освободите место в своём аккаунте на vibefox.net.

Без активного ключа Cargoson не показывается покупателям при оформлении заказа. Администраторы магазина, вошедшие в систему, по-прежнему его видят, с пометкой (unlicensed — visible to admins only), чтобы вы могли настроить и протестировать плагин до покупки ключа. Напоминание появляется на странице Plugins и на страницах WooCommerce. Существующие заказы не затрагиваются.

Когда срок лицензии истекает, плагин продолжает работать, но для обновлений и поддержки нужно продление. Статус автоматически проверяется в фоновом режиме.

Устранение неполадок

Cargoson не появляется при оформлении заказа: проверьте, что лицензия активна, опция Enable/Disable включена и метод добавлен в зону страны покупателя (или включена опция Ignore shipping zones, а страна разрешена). Проверьте ограничения по весу, Minimum order amount и Excluded shipping classes. В режиме фиксированных цен убедитесь, что для страны или * Default есть цена для размера корзины.

Тарифы в реальном времени не появляются: откройте WooCommerce > Status > Logs, источник vfd_cargoson. Ошибки API записываются всегда; включите Debug log, чтобы видеть каждый расчёт. Типичные причины: почтовый индекс доставки ещё не введён, нет почтового индекса отправки, ключ API отклонён (неверный или истёкший ключ либо нет доступа к API в вашем тарифе Cargoson), нет перевозчика для маршрута или веса, либо цена в другой валюте. С опцией Cargoson live prices, fixed prices if the API fails покупатели всё равно получают фиксированную цену, пока вы устраняете проблему.

Cargoson отклоняет тип упаковки: используйте код упаковки, который ваш аккаунт Cargoson применяет в поле Package type code. Причина отображается в журнале.

Цена в другой валюте отклоняется: установите Price currency в валюту ваших тарифов Cargoson и укажите Currency conversion rate.

Тарифы выглядят устаревшими после изменения: сохраните страницу настроек. Это очистит кэшированные тарифы Cargoson.

Блок лицензии показывает ошибку: следуйте сообщению в блоке. Например, если ключ уже используется на другом домене, освободите место в своём аккаунте на vibefox.net и нажмите Check now. Если адрес сайта изменился, нажмите Check now, чтобы активировать ключ для нового домена. Если сервер лицензий недоступен, плагин продолжает работать по последнему известному статусу.

Удаление

Деактивация плагина сохраняет все данные. Чтобы удалить его, деактивируйте и удалите его на странице Plugins. Лицензионный ключ и статус лицензии этого плагина удаляются всегда. Настройки, методы зон и кэшированные тарифы удаляются, только если была включена опция Remove data on uninstall. Иначе они сохраняются для повторной установки. Существующие заказы сохраняют свои строки доставки.

Cargoson — товарный знак его владельца. Этот плагин не связан с Cargoson и не одобрен компанией Cargoson.