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.

Способ доставки работает в классическом оформлении заказа и в блоках «Корзина» и «Оформление заказа». Он совместим с 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 и не одобрен компанией Bob Go.