VibeFox Bob Go for WooCommerce — Допомога

Вимоги

WordPress: 5.8 або новіша версія.

WooCommerce: 5.0 або новіша, встановлений і активний. Плагін не активується без нього.

PHP: 8.0 або новіша версія.

Обліковий запис Bob Go (лише для тарифів у реальному часі): Bob Go не має API-ключів. Вам потрібні обліковий запис Bob Go (bobgo.co.za), ваш магазин WooCommerce, встановлений як канал продажів в обліковому записі Bob Go (Sales channels), і увімкнений «Rates at checkout» для цього каналу, з налаштованими там послугами та цінами. Якщо ви використовуєте лише фіксовані ціни, обліковий запис Bob Go не потрібен.

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

Встановлення

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

2. Натисніть Activate.

3. В обліковому записі Bob Go встановіть ваш магазин WooCommerce як канал продажів. Увімкніть «Rates at checkout» для цього каналу та налаштуйте послуги й ціни.

4. Відкрийте налаштування: WooCommerce > Settings > Shipping > VibeFox Bob Go або натисніть Settings під назвою плагіна на сторінці Plugins.

5. Введіть ліцензійний ключ VibeFox у блоці ліцензії вгорі сторінки та натисніть Activate.

6. Перевірте домен магазину, адресу відправлення (ship from) і, якщо валюта магазину не ZAR, курс конвертації в ZAR (див. Налаштування).

7. Додайте VibeFox Bob Go до зони доставки для Південної Африки в WooCommerce > Settings > Shipping > Shipping zones або увімкніть Ignore shipping zones.

Налаштування

Усі налаштування розміщені на одній сторінці: WooCommerce > Settings > Shipping > VibeFox Bob Go. Вони застосовуються до всіх зон доставки. Щоразу, коли ви зберігаєте налаштування, кешовані тарифи Bob Go очищуються. Коли ви додаєте метод до зони, у вікні зони лише одне поле:

Title (zone): назва, яка показується для фіксованих цін і безкоштовної доставки в цій зоні. Залиште порожнім, щоб використовувати загальний Method title. Тарифи Bob Go у реальному часі завжди показуються з назвами послуг, налаштованими в Bob Go.

Загальні

Enable/Disable: вмикає або вимикає метод у всіх зонах одночасно.

Method title: показується покупцеві для фіксованих цін і безкоштовної доставки. Зона може його перевизначити. Тарифи Bob Go у реальному часі показуються з назвами послуг від Bob Go, наприклад «The Courier Guy - Economy». За замовчуванням: Bob Go.

Shipping cost: спосіб розрахунку ціни.

Причина відсутності тарифів у реальному часі записується в журнал. Покупцеві вона ніколи не показується.

Обліковий запис Bob Go

Цей розділ показує останню відповідь Bob Go для домену вашого магазину: connected, the WooCommerce channel is not installed on Bob Go (HTTP 404), "Rates at checkout" is not enabled for this channel (HTTP 401) або іншу помилку. Якщо валюта магазину не ZAR і курс конвертації не задано, розділ також попереджає, що тарифи в реальному часі не запитуються.

Store domain: Bob Go ідентифікує ваш магазин за доменом. Залиште порожнім, щоб використовувати домен вашого сайту. Вказуйте інший домен, лише якщо ваш канал у Bob Go встановлено за іншою адресою, наприклад example.co.za/shop для магазину в підпапці.

ZAR conversion rate: Bob Go котирує в південноафриканських рандах (ZAR). Якщо валюта вашого магазину не ZAR, вкажіть, скільки коштує 1 ZAR у валюті магазину, наприклад 0.05 для EUR. За цим курсом тарифи конвертуються, а ціни товарів передаються в Bob Go у ZAR. Залиште порожнім, щоб не використовувати тарифи Bob Go у реальному часі у вашій валюті (фіксовані ціни працюють). Якщо валюта магазину ZAR, залиште порожнім. Як десятковий роздільник приймаються і крапка, і кома.

Delivery dates: показує в назві тарифу орієнтовний діапазон дат доставки від Bob Go. Орієнтовний строк завжди зберігається разом із замовленням і видно на екрані замовлення.

Відправлення з (адреса відправлення)

Адреса відправлення передається в Bob Go із кожним запитом тарифів. Якщо адреса вашого магазину в WooCommerce > Settings > General знаходиться в тій самій країні, порожні поля заповнюються з неї.

Origin country: країна, з якої ви відправляєте. За замовчуванням: Південна Африка. Bob Go доставляє лише всередині Південної Африки.

Origin province: південноафриканська провінція або Store province (if in South Africa).

Origin city / suburb: місто або передмістя, з якого ви відправляєте, наприклад Йоганнесбург.

Origin postal code: поштовий індекс, з якого ви відправляєте, наприклад 2001.

Origin street address: адреса вулиці, з якої ви відправляєте.

Фіксовані ціни (використовуються у фіксованому режимі та як запасний варіант, коли Bob Go не повертає тарифів)

Price per country: один рядок на країну: дволітерний код країни, знак рівності та ціна у валюті магазину, наприклад ZA=99.99. Для всіх інших країн використовуйте *, наприклад *=199.99. Рядки в іншому форматі видаляються під час збереження.

Flat price: ціна у валюті магазину для країн без рядка вище. Залиште порожнім, щоб приховати метод для цих країн.

Fixed price applies: Per order стягує ціну один раз. Per item (price × quantity) множить її на кількість товарів у кошику. Тарифи Bob Go у реальному часі завжди стосуються всього відправлення.

Умови

Minimum weight (kg): приховує метод, якщо вага кошика менша за це значення. 0 означає без обмеження.

Maximum weight (kg): приховує метод, якщо вага кошика більша за це значення. 0 означає без обмеження (за замовчуванням).

Minimum order amount: показує метод лише тоді, коли проміжна сума кошика (після знижок, до податків) становить щонайменше цю суму. Залиште порожнім, щоб показувати його завжди.

Excluded shipping classes: приховує метод, якщо в кошику є товар із будь-якого з цих класів доставки WooCommerce.

Free shipping: вмикає безкоштовну доставку, коли досягнуто суму замовлення, вказану нижче.

Free shipping from: проміжна сума кошика (після знижок, до податків), починаючи з якої доставка безкоштовна. Використовується лише коли ввімкнено Free shipping. У цьому випадку Bob Go не запитується.

Tax status: Taxable додає податок WooCommerce до вартості доставки, None — ні. Тарифи Bob Go зазвичай уже включають ПДВ. У такому разі оберіть None, щоб не стягувати податок двічі.

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

Ignore shipping zones: пропонує Bob Go для країн, вказаних нижче, навіть якщо його не додано до зони доставки.

Countries: країни призначення для цього режиму. Залиште порожнім, щоб використовувати всі країни, куди ви доставляєте. Використовується лише коли ввімкнено Ignore shipping zones.

Додатково

Debug log: записує розрахунки тарифів і запити до Bob Go в WooCommerce > Status > Logs, джерело «vfd_bob_go». Адреси покупців не записуються. Помилки API записуються, навіть коли цю опцію вимкнено.

Remove data on uninstall: якщо увімкнено, видалення плагіна стирає всі налаштування Bob Go, методи зон і кешовані тарифи. Деактивація плагіна ніколи нічого не видаляє.

Як це працює під час оформлення замовлення

Коли покупець вводить адресу доставки, плагін перевіряє вагу кошика, Minimum order amount і Excluded shipping classes. Якщо застосовується безкоштовна доставка, покупець бачить метод як Bob Go (free), і жодного запиту до Bob Go не надсилається.

У режимах у реальному часі плагін надсилає в Bob Go домен вашого магазину, адреси відправлення та доставки і товари кошика з цінами у ZAR. Тарифи в реальному часі запитуються лише після того, як покупець вкаже місто або поштовий індекс. Кожна послуга, яку повертає Bob Go, показується як окремий варіант доставки з її назвою від Bob Go і, якщо ввімкнено Delivery dates, з орієнтовними датами доставки. Тарифи в ZAR конвертуються за курсом ZAR conversion rate, коли валюта магазину не ZAR.

Тарифи кешуються на 1 годину для кожного кошика та адреси, тож той самий кошик не викликає нового запиту. Невдалий запит кешується на 5 хвилин, а тайм-аут становить 12 секунд, щоб збій Bob Go не сповільнював кожне оновлення оформлення замовлення. Невдалий запит ніколи не порушує оформлення замовлення: метод приховується або, у режимі із запасним варіантом, використовується фіксована ціна. Причина записується в журнал WooCommerce.

Обраний код послуги Bob Go і орієнтовний строк доставки зберігаються разом з рядком доставки замовлення та показуються на екрані замовлення як Bob Go service і Estimated delivery.

Метод працює в класичному оформленні замовлення та в блоках Cart і Checkout. Він сумісний з WooCommerce High-Performance Order Storage (HPOS).

Плагін лише показує тарифи. Він не створює відправлень, накладних чи етикеток, не відстежує посилки, не синхронізує замовлення з Bob Go і не надсилає сповіщення електронною поштою. Для виконання замовлень користуйтеся панеллю Bob Go (або власною синхронізацією замовлень Bob Go). Вибору пункту видачі чи поштомата (Bob Box, Pargo) і додаткового поля для району на етапі оформлення немає. Bob Go доставляє лише всередині Південної Африки.

Ліцензійний ключ

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

Один ключ працює на одному домені. Видалення ключа з сайту не звільняє слот домену. Звільніть слот в обліковому записі на vibefox.net.

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

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

Усунення несправностей

Bob Go не з'являється під час оформлення замовлення: перевірте, чи ліцензія активна, чи увімкнено Enable/Disable і чи додано метод до зони країни покупця (або чи увімкнено Ignore shipping zones і чи дозволено країну). Перевірте обмеження ваги, Minimum order amount і Excluded shipping classes. У фіксованому режимі переконайтеся, що для країни, * або Flat price є ціна.

Тарифи Bob Go не показуються: відкрийте налаштування плагіна. Розділ Bob Go account показує останню відповідь Bob Go. «Channel is not installed» (HTTP 404) означає, що домен магазину не є каналом продажів у Bob Go: перевірте Store domain. «Rates at checkout is not enabled» (HTTP 401) означає, що функцію вимкнено для каналу. Також переконайтеся, що покупець вказав місто або поштовий індекс, а для магазинів не в ZAR — що задано ZAR conversion rate. Увімкніть Debug log і відкрийте WooCommerce > Status > Logs (джерело «vfd_bob_go») для деталей. З опцією Bob Go live rates, fixed prices if Bob Go returns no rates покупці все одно отримуватимуть фіксовану ціну, поки ви виправляєте проблему.

Мій магазин не в рандах: Bob Go котирує в ZAR. Вкажіть, скільки коштує 1 ZAR у валюті вашого магазину (наприклад, 0.05 для EUR). Без цього плагін не запитує тарифи в Bob Go. Фіксовані ціни працюють.

Податок на доставку стягується двічі: тарифи Bob Go зазвичай уже включають ПДВ. Встановіть Tax status на None.

Тарифи виглядають застарілими після змін: збережіть сторінку налаштувань. Це очистить кешовані тарифи Bob Go. Зміни в обліковому записі Bob Go підхоплюються після 1-годинного кешу або під час збереження налаштувань.

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

Видалення

Деактивація плагіна зберігає всі дані. Щоб видалити його, деактивуйте та видаліть на сторінці Plugins. Ліцензійний ключ і статус ліцензії цього плагіна видаляються завжди. Налаштування, методи зон і кешовані тарифи видаляються, лише якщо була ввімкнена опція Remove data on uninstall. Інакше вони зберігаються для повторного встановлення. Наявні замовлення зберігають свої рядки доставки.

Bob Go — торгова марка її власника. Цей плагін не пов'язаний із Bob Go і не схвалений нею.