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 і не схвалений нею.