VibeFox GIG Logistics for WooCommerce — Помощь

Требования

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

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

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

Учётные данные API GIG Logistics (только для цен в реальном времени): цены в реальном времени используют сторонний API GIG Logistics. GIG Logistics выдаёт корпоративным клиентам имя пользователя API (обычно адрес электронной почты) и пароль. Запросите их на странице разработчиков GIG Logistics (giglogistics.com/developer). Тестовые учётные данные работают только с тестовым API. Если вы используете только таблицу цен и резервную стоимость, учётные данные API не нужны.

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

Установка

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

2. Нажмите Activate.

3. Откройте настройки: WooCommerce > Settings > Shipping > VibeFox GIG Logistics, или нажмите Settings под названием плагина на странице «Плагины».

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

5. Заполните таблицу цен и/или резервную стоимость. Для цен в реальном времени также введите имя пользователя и пароль API, телефон отправителя, город и штат отправления, а также курс конвертации валюты, если валюта вашего магазина не NGN (см. раздел «Настройка»).

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

Настройка

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

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

Над полями страница показывает предупреждения, если цены в реальном времени не могут использоваться: введено только одно из двух — имя пользователя или пароль API, не заполнены Sender phone или город и штат отправления, либо валюта магазина не NGN и не задан Currency conversion rate. Каждый раз при сохранении настроек кэшированные цены и токены API очищаются.

General

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

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

Tax status: Taxable добавляет налог на доставку вашего магазина к стоимости, None — не добавляет. Выберите None, если цена GIG уже включает всё, что вы хотите взимать.

API GIG Logistics (цены в реальном времени) (необязательно)

С учётными данными API цена запрашивается у GIG Logistics для каждого адреса в Нигерии. Без учётных данных или когда API не возвращает цену, используются таблица цен и резервная стоимость.

API username: имя пользователя стороннего API GIG Logistics, обычно ваш адрес электронной почты.

API password: пароль стороннего API GIG Logistics. Используется только для входа в API и никогда не записывается в журнал.

Test mode: использовать тестовый API (dev) GIG Logistics. Тестовые учётные данные работают только с тестовым API. Выключите, чтобы получать реальные цены. По умолчанию: выключено.

Currency conversion rate: GIG Logistics возвращает цены в NGN. Если валюта вашего магазина не NGN, укажите, сколько стоит один NGN в валюте вашего магазина (1 NGN = ? вашей валюты, например 0.0006). Без этого значения цены GIG в реальном времени не используются. Если валюта магазина — NGN, это поле не нужно. В качестве десятичного разделителя принимаются и точка, и запятая.

Адрес отправления (отправитель)

Место, где GIG Logistics забирает посылки, в Нигерии. Если ваш магазин находится в Нигерии, пустые поля улицы, города и штата берут адрес магазина из WooCommerce > Settings > General.

Sender name: имя отправителя, которое передаётся в GIG Logistics. Если пусто, используется название сайта.

Sender phone: ваш телефон, например 08030000000. GIG Logistics требует его для цен в реальном времени.

Street address: адрес улицы отправления.

City / area: город или район отправления, например Victoria Island. Обязательно для цен в реальном времени.

State: нигерийский штат адреса отправления. По умолчанию используется штат магазина. Обязательно для цен в реальном времени.

Pickup latitude: необязательная широта точки отправления на карте, например 6.4281. GIG Logistics считает цену по расстоянию. Если пусто, координаты определяются по адресу.

Pickup longitude: необязательная долгота точки отправления на карте, например 3.4219.

Address lookup: определять координаты адресов на карте с помощью OpenStreetMap (Nominatim). GIG Logistics рассчитывает цену по координатам отправления и доставки. Улица, город и штат покупателя отправляются на nominatim.openstreetmap.org, результаты кэшируются на 30 дней. Без этой опции отправляется только текст адреса, и GIG Logistics может не вернуть цену. По умолчанию: включено.

Таблица цен и резервная стоимость

Используется для других стран, когда цены в реальном времени не настроены или когда GIG Logistics не возвращает цену. Цены указываются в валюте вашего магазина.

Country prices: таблица с базовой ценой для каждой страны. Нажмите Add country, чтобы добавить строку, и крестик, чтобы удалить. Выберите * Any other country для всех стран без собственной строки. Колонки XS (до 1 кг), S (до 2 кг), M (до 3 кг), L (до 5 кг) и XL (свыше 5 кг) — необязательные цены для весовых диапазонов: цена диапазона выше 0 заменяет базовую цену для корзин этого диапазона. Цена 0 означает бесплатную доставку. Пустые ячейки цен сохраняются как 0, поэтому заполняйте базовую цену для каждой добавленной строки. Страны без строки (если строки * нет) не получают табличной цены.

Fallback cost: используется, когда ни GIG Logistics, ни таблица не дают цену. Если пусто, способ доставки в этом случае скрывается.

Table / fallback price is: Per order — цена берётся один раз. Per item (multiplied by the number of items) — цена умножается на количество товаров в корзине. Цены GIG в реальном времени всегда указаны за весь заказ.

Условия

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

Minimum subtotal: показывать способ доставки только тогда, когда промежуточная сумма корзины достигает этой суммы. Если пусто, показывается всегда.

Min weight (kg): минимальный вес корзины в кг. Веса товаров пересчитываются из единицы веса вашего магазина. 0 — без ограничения.

Max weight (kg): максимальный вес корзины в кг. По умолчанию: 30. 0 — без ограничения.

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

Доступность без зон доставки

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

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

Дополнительно

Debug log: записывать расчёты цен в WooCommerce > Status > Logs, источник vfd-gig-logistics. Ошибки API записываются всегда, даже при выключенном журнале. Пароли, токены и адреса покупателей не записываются.

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

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

Когда покупатель вводит адрес доставки, WooCommerce запрашивает у плагина цену. Сначала плагин проверяет условия: страна доставки, вес корзины, минимальная промежуточная сумма и исключённые классы доставки. Если промежуточная сумма достигает Free shipping from, способ доставки показывается с ценой 0, но только если для страны есть цена: строка в Country prices, Fallback cost или цена GIG Logistics в реальном времени. GIG Logistics запрашивается только тогда, когда таблица и резервная стоимость не дают цену.

Затем цена берётся из первого источника, который её даёт. Сначала — цена GIG Logistics в реальном времени, если введены учётные данные API, адрес находится в Нигерии, покупатель указал город или штат, заполнены телефон, город и штат отправления, а для магазинов не в NGN задан курс конвертации. Плагин входит в API GIG Logistics и передаёт адреса и координаты отправления и доставки, а также товары корзины с названиями, количеством, весом и стоимостью. Товары без веса передаются как 1 кг. Цена запрашивается для доставки на bike. Во-вторых — таблица Country prices. В-третьих — Fallback cost. Если ни один источник не даёт цену, способ доставки для этой корзины скрывается.

Каждый ответ GIG кэшируется на 1 час, поэтому та же корзина не вызывает новый запрос. Неудачный запрос или неудачный вход кэшируется на 10 минут, чтобы оформление заказа не ждало GIG Logistics при каждом обновлении. Токен входа хранится 30 минут и автоматически обновляется, когда GIG его отклоняет. Таймаут API — 10 секунд, таймаут поиска адреса — 5 секунд.

Если GIG Logistics возвращает ошибку или нулевую цену, покупатель не видит ошибки. Используется цена из таблицы или резервная стоимость, а ошибка записывается в журнал.

Способ доставки работает при классическом оформлении заказа и в блоках «Корзина» и «Оформление заказа». Он совместим с высокопроизводительным хранилищем заказов WooCommerce (HPOS).

Плагин только рассчитывает цены. Он не создаёт отправления, накладные или этикетки GIG Logistics, не заказывает забор посылок, не отслеживает посылки и не позволяет покупателям выбирать сервисный центр. Заказы отправляются через ваш аккаунт GIG Logistics как обычно. Цены в реальном времени запрашиваются только для адресов в Нигерии. Для других стран используйте таблицу цен.

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

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

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

Без активного ключа GIG Logistics не показывается покупателям при оформлении заказа. Вошедшие менеджеры магазина видят его, отмеченным (unlicensed — visible to admins only), чтобы вы могли настроить и протестировать плагин до покупки ключа. Напоминание появляется на странице «Плагины» и на страницах WooCommerce. Существующие заказы не затрагиваются.

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

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

GIG Logistics не появляется при оформлении заказа: проверьте, что лицензия активна, что Enable/Disable включено и способ доставки добавлен в зону страны покупателя (или что включено Ignore shipping zones и страна разрешена). Проверьте ограничения по весу, Minimum subtotal и Excluded shipping classes. Проверьте, что таблица (страна или *) или Fallback cost дают цену для страны.

Цена берётся из таблицы, а не из GIG Logistics: цены в реальном времени требуют имя пользователя и пароль API, Sender phone, город и штат отправления, адрес доставки в Нигерии с городом или штатом, а для магазинов не в NGN — Currency conversion rate. Посмотрите предупреждения вверху страницы настроек. Включите Debug log, перезагрузите оформление заказа и откройте WooCommerce > Status > Logs, источник vfd-gig-logistics, чтобы увидеть причину. Неудачный запрос повторяется через 10 минут.

Login failed в журнале: GIG Logistics отклонил имя пользователя или пароль API. Проверьте их и проверьте Test mode: тестовые учётные данные работают только с тестовым API. Сохраните настройки, чтобы сразу повторить попытку.

GIG Logistics не возвращает цену: GIG считает цену по расстоянию. Оставьте Address lookup включённым или введите Pickup latitude и Pickup longitude. Перед запуском проверьте цены в своём аккаунте GIG Logistics.

Налог начисляется сверх цены GIG: установите Tax status в None, если цена GIG уже включает всё, что вы хотите взимать.

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

Собственный геокодер: разработчики могут подключить свой поиск адресов через фильтр vfd_gigl_pre_geocode.

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

Удаление

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

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