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

Вимоги

OpenCart: 3.0.x (перевірено на 3.0.5.0) або 4.0.2 і новіше (перевірено на 4.1.0.3).

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

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

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

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

Завантаження являє собою один zip-файл із пакетами для обох версій OpenCart. Розпакуйте його на своєму комп'ютері. Він містить README.txt, пакет для OpenCart 3 vfd_bob_go-oc3-(version).ocmod.zip і пакет для OpenCart 4 vfd_bob_go.ocmod.zip. Встановлюйте лише пакет для вашої версії OpenCart. Ліцензійний ключ однаковий для обох версій.

OpenCart 3

1. В адмінпанелі перейдіть до Extensions > Installer, натисніть Upload і виберіть файл vfd_bob_go-oc3-(version).ocmod.zip. Розширення не додає модифікацій OCMOD, тож оновлювати Extensions > Modifications не потрібно. Замість інсталятора можна також скопіювати вміст папки upload з пакета в кореневу папку вашого магазину.

2. Перейдіть до Extensions > Extensions і оберіть тип розширення Shipping. Знайдіть VibeFox Bob Go і натисніть Install (зелена кнопка +).

3. Натисніть Edit (кнопка з олівцем), щоб відкрити сторінку налаштувань.

4. Введіть свій ліцензійний ключ VibeFox у поле License key у блоці ліцензії у верхній частині сторінки Edit і натисніть Activate (див. Ліцензійний ключ).

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

6. На сторінці Edit перевірте домен магазину, адресу відправлення (звідки ви відправляєте) і, якщо валюта вашого магазину не ZAR, курс конвертації в ZAR (див. Конфігурація). Увімкніть Enable Bob Go і натисніть Save.

OpenCart 4

1. В адмінпанелі перейдіть до Extensions > Installer, натисніть Upload і виберіть файл vfd_bob_go.ocmod.zip. Не перейменовуйте файл: OpenCart 4 бере код розширення з назви файлу, і перейменований пакет не працює.

2. Пакет з'являється у списку встановлених розширень на тій самій сторінці. Натисніть поруч із ним Install (зелена кнопка +).

3. Перейдіть до Extensions > Extensions і оберіть тип Shipping. Знайдіть VibeFox Bob Go, натисніть Install (зелена кнопка +), потім Edit (кнопка з олівцем).

4. Налаштуйте Bob Go, введіть ліцензійний ключ і налаштування так само, як у кроках 4–6 для OpenCart 3. Сторінка налаштувань та її поля однакові в обох версіях.

Після встановлення метод вимкнений, доки ви не увімкнете Enable Bob Go і не збережете налаштування. За замовчуванням використовуються тарифи Bob Go у реальному часі. Якщо ви встановите розширення повторно після видалення, збережені налаштування Bob Go знову будуть використані.

Конфігурація

Усі налаштування розташовані на сторінці розширення: Extensions > Extensions > Shipping > VibeFox Bob Go > Edit. Розділи перелічені ліворуч. Одна кнопка Save зберігає всю сторінку без перезавантаження. Кожне збереження також очищає кеш тарифів Bob Go. Числа приймають крапку або кому як десятковий роздільник. Якщо значення неправильне, нічого не зберігається, і сторінка показує причину: порожній Method title або довший за 64 символи, значення, що не є числом ("…" must be a number.), від'ємна сума чи вага ("…" must be a number of 0 or more.), ZAR conversion rate 0 або менше, Minimum weight (kg) більше за Maximum weight (kg), або невідомий податковий клас чи географічна зона. Зберігати налаштування можуть лише адміністратори з правом змінювати це розширення.

Над налаштуваннями сторінка попереджає, коли тарифи в реальному часі не можуть працювати: Live rates are not requested: your store currency is … — set the "ZAR conversion rate"., коли в магазині немає зон (провінцій) для Південної Африки, або коли в магазині немає класу ваги з одиницею «kg» чи класу довжини з одиницею «cm». В останньому випадку вага та розміри перераховуються за назвою одиниці їхнього класу (kg, g, lb, oz; cm, mm, m, in), а інші одиниці читаються як kg або cm.

Загальні

Налаштування діють для кожної географічної зони. Під час оформлення замовлення кожна послуга Bob Go є окремим варіантом доставки під назвою методу.

Enable Bob Go: показує або приховує Bob Go під час оформлення замовлення. За замовчуванням: вимкнено.

Method title: назва способу доставки, яку бачить покупець. Послуги Bob Go, наприклад "The Courier Guy - Economy", перелічуються під нею з назвами з Bob Go. За замовчуванням: Bob Go. Обов'язкове поле, не більше 64 символів.

Shipping cost: як розраховується ціна.

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

Sort order: позиція Bob Go серед способів доставки під час оформлення замовлення. Ціле число.

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

Цей розділ пояснює, що потрібно зробити в Bob Go, з посиланнями на ваш обліковий запис Bob Go, Sales channels і Rates at checkout. Він також показує останню відповідь 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 або 403), або request failed з кодом помилки чи no connection.

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

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

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

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

Адреса відправлення передається в Bob Go із кожним запитом тарифів. Адреса магазину в OpenCart є вільним текстом, тому використовуються лише країна та регіон вашого магазину (System > Settings > Store > Local): якщо країна магазину є країною відправлення, порожня провінція береться з регіону магазину. Вкажіть тут місто, поштовий індекс і вулицю.

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

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

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

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

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

Фіксовані ціни (використовуються, коли Shipping cost має значення Fixed prices (below), а також як запасний варіант, коли 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: показує метод лише тоді, коли проміжна сума товарів, що потребують доставки (після купона, без податків), досягає цього значення. Залиште поле порожнім, щоб показувати метод завжди.

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

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

Tax class: податковий клас вартості доставки або No tax (за замовчуванням). Тарифи Bob Go зазвичай вже включають ПДВ. У такому разі залиште No tax, щоб податок на доставку не стягувався двічі.

Geo zone: пропонувати Bob Go лише для адрес у цій географічній зоні. All zones (за замовчуванням) означає без обмежень. Не використовується, коли Ignore shipping zones увімкнено. Географічні зони керуються в System > Localisation > Geo Zones.

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

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

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

Додатково

Debug log: записує розрахунки тарифів і запити до Bob Go у storage/logs/vfd_bobg_debug.log.php. Файл неможливо прочитати через веб. Адреси покупців не записуються. Помилки Bob Go записуються навіть тоді, коли цей параметр вимкнено. Вимкніть журнал, коли закінчите. Коли файл досягає 5 МБ, його переміщують до vfd_bobg_debug.old.log.php і починають новий журнал.

Log: показує розмір і останні записи журналу. Натисніть Clear log, щоб очистити його.

Remove data on uninstall: коли увімкнено, видалення розширення стирає налаштування Bob Go, кеш тарифів і журнали. Послуга Bob Go, збережена із замовленнями, зберігається. Коли вимкнено (за замовчуванням), усе зберігається для повторного встановлення.

Імпорт / експорт

Export: натисніть Download JSON, щоб зберегти налаштування у файл JSON.

Import: вставте раніше експортований JSON і натисніть Import, щоб відновити налаштування, наприклад в іншому магазині. Значення перевіряються так само, як під час звичайного збереження.

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

Коли OpenCart показує способи доставки, він запитує в розширення тарифи Bob Go. Якщо задано Geo zone (а Ignore shipping zones вимкнено) і адреса знаходиться поза нею, Bob Go не пропонується. Враховуються лише товари з Requires Shipping, встановленим у Yes: інші товари не додають ваги й не входять до суми замовлення. Далі розширення перевіряє країну призначення (за умови Ignore shipping zones), вагу кошика та Minimum order amount. Сума замовлення — це ціна товарів, що потребують доставки, після знижки за купоном і до податків. Подарункові сертифікати, бонусні бали та кредит магазину не враховуються. Якщо діє безкоштовна доставка, покупець бачить Bob Go (free) (ваш Method title), і запит до Bob Go не надсилається.

У режимах тарифів у реальному часі розширення надсилає в Bob Go домен вашого магазину, адреси відправлення та доставки (з провінцією) і товари кошика: ціни товарів у ZAR, ваги та розміри, а також модель товару як SKU. Для південноафриканських адрес зона OpenCart надсилається як код провінції (EC, FS, GP, KZN, LP, MP, NC, NW, WC). Тарифи в реальному часі запитуються лише після того, як покупець ввів місто або поштовий індекс. Тарифи в ZAR перераховуються за ZAR conversion rate, якщо валюта вашого магазину не ZAR. Ціна розраховується в основній валюті, округлюється до її десяткових знаків і показується покупцю в його валюті з податком обраного Tax class.

Під назвою методу покупець бачить один варіант на кожну послугу Bob Go, з її назвою, ціною та, якщо увімкнено Delivery dates, орієнтовними датами доставки в дужках. Покупець обирає послугу, як і будь-який інший варіант доставки в OpenCart. За фіксованої ціни є один варіант з назвою методу.

В OpenCart 4 покупець натискає Choose у блоці способу доставки на сторінці оформлення замовлення і вибирає послугу Bob Go у вікні Shipping method options, наприклад SkyNet - Overnight (by 17/10/2026) із ціною. Спосіб працює так само, як в OpenCart 3.

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

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

Замовлення

Назва обраної послуги стає способом доставки замовлення, тож вона з'являється в електронних листах із замовленням, у розділі Sales > Orders та в обліковому записі покупця. Під час оформлення замовлення послуга Bob Go, її код і оцінка доставки також зберігаються із замовленням. Пізніші зміни кошика чи цін Bob Go їх не змінюють. В OpenCart 4 оформлення замовлення зберігає одне замовлення: якщо покупець повернеться назад і знову підтвердить замовлення з іншою послугою Bob Go, збережена послуга оновиться, а з іншим способом доставки або фіксованою ціною її буде видалено.

В адмінпанелі сторінка замовлення в розділі Sales > Orders показує блок Bob Go із Bob Go service (назва і код) та Estimated delivery. Покупець бачить Bob Go service і Estimated delivery на сторінці деталей замовлення у своєму обліковому записі. Замовлення з фіксованою ціною або безкоштовною доставкою не мають послуги Bob Go.

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

Розширення працює з ліцензійним ключем VibeFox з vibefox.net. Блок ліцензії License — VibeFox Bob Go є першим блоком на сторінці Extensions > Extensions > Shipping > VibeFox Bob Go > Edit, над налаштуваннями. Введіть ключ у поле License key і натисніть Activate. Після цього блок показує ключ у замаскованому вигляді, статус (наприклад, дату, до якої ліцензія активна, і ваш домен) та кнопки Check now для повторної перевірки статусу, Change key для введення іншого ключа і Remove key для видалення ключа з цього магазину. Нижче розташовані рядок Product: opencart-shipping-bob-go і посилання Manage licenses and domains in your account, яке відкриває ваш обліковий запис vibefox.net. Змінювати ключ можуть лише адміністратори з правом Modify для розширення. Тексти блоку відповідають мові адмінпанелі (включено англійську та російську).

Якщо ключ не прийнято, блок повідомляє причину, наприклад Key not found, This key belongs to another product, Domain limit reached або License expired on з датою. Після зміни адреси магазину або після звільнення слота домену у вашому обліковому записі натисніть Check now. Якщо сервер ліцензій недоступний, розширення продовжує працювати за останнім відомим статусом.

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

Без активного ключа Bob Go не показується покупцям під час оформлення замовлення, і тарифи не розраховуються. Адміністратор, який увійшов в адмінпанель у тому самому браузері, все одно бачить метод у магазині з позначкою (unlicensed — visible to admins only), тож ви можете налаштувати й перевірити розширення до купівлі ключа. В OpenCart 4 цей перегляд недоступний: магазин не бачить вхід адміністратора, тому без активного ключа метод приховано для всіх. Після першого відкриття сторінки Edit на Dashboard адмінпанелі з'являється нагадування. Закрийте його кнопкою ×, щоб приховати на 7 днів. Наявні замовлення не змінюються.

Коли ліцензія завершується, розширення продовжує працювати, але для оновлень і підтримки потрібне продовження. Статус перевіряється знову автоматично, коли ви відкриваєте Dashboard або сторінку Edit в адмінпанелі: раз на день протягом перших 14 днів після введення ключа, потім раз на тиждень. Cron-завдання не потрібне. Видалення розширення завжди видаляє ліцензійний ключ і статус ліцензії.

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

Bob Go не з'являється під час оформлення замовлення: перевірте, що ліцензія активна і Enable Bob Go увімкнено. Перевірте Geo zone або увімкніть Ignore shipping zones і перевірте Countries. Перевірте обмеження ваги та Minimum order amount. У режимі фіксованих цін перевірте, що для країни, * або Flat price є ціна. Перевірте, що в товарів Requires Shipping встановлено Yes.

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

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

Сторінка попереджає, що в Південної Африки немає зон: додайте провінції Південної Африки в System > Localisation > Zones, інакше Bob Go не отримає провінцію для південноафриканських адрес.

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

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

Сторінка пише «Warning: You do not have permission to modify VibeFox Bob Go!»: ваша група адміністраторів, ймовірно, може лише переглядати налаштування. Надайте групі право змінювати extension/shipping/vfd_bob_go (OpenCart 3) або extension/vfd_bob_go/shipping/vfd_bob_go (OpenCart 4) у System > Users > User Groups.

Для розробників: адресу API Bob Go можна замінити налаштуванням vfd_bobg_api_url (для тестів); для нього немає поля на сторінці налаштувань.

Видалення

Перейдіть до Extensions > Extensions, оберіть тип Shipping і натисніть Uninstall (червона кнопка −) поруч із VibeFox Bob Go. Ліцензійний ключ і статус ліцензії цього розширення завжди видаляються. OpenCart завжди скидає Enable Bob Go, Sort order, Tax class і Geo zone. Кеш тарифів завжди видаляється. Якщо Remove data on uninstall увімкнено, налаштування Bob Go і журнал також видаляються. Якщо вимкнено, інші налаштування зберігаються і знову використовуються при повторному встановленні розширення. Послуга Bob Go, збережена із замовленнями, завжди зберігається, а наявні замовлення зберігають свій спосіб доставки та вартість.

В OpenCart 4, щоб видалити також файли розширення, після видалення перейдіть до Extensions > Installer, натисніть Uninstall (помаранчева кнопка −) поруч із VibeFox Bob Go у списку встановлених розширень, потім Delete (червона кнопка з кошиком), щоб видалити завантажений пакет.

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