VibeFox The Courier Guy for WooCommerce — Помощь

Требования

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

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

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

Ключ API ShipLogic (для тарифов в реальном времени и постаматов): The Courier Guy работает на платформе ShipLogic. Создайте ключ API в курьерском портале The Courier Guy, в разделе Settings > API Keys (бизнес-аккаунт). Без ключа используется только таблица цен, и доставку в постамат предложить нельзя.

Доставка в ЮАР: тарифы в реальном времени и постаматы работают только для адресов в ЮАР. Ваш магазин должен доставлять в ЮАР (WooCommerce > Settings > General > Shipping location(s)).

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

Установка

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

2. Нажмите Activate.

3. Откройте настройки: WooCommerce > Settings > Shipping > VibeFox The Courier Guy или нажмите Settings под названием плагина на странице Plugins.

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

5. Введите API key ShipLogic. Для тарифов в реальном времени заполните адрес отправителя (улица, город, провинция, почтовый индекс) и, если валюта вашего магазина не ZAR, — ZAR conversion rate.

6. Заполните таблицу цен и/или резервную стоимость.

7. Добавьте VibeFox The Courier Guy в зону доставки для ЮАР в разделе WooCommerce > Settings > Shipping > Shipping zones, выберите Delivery type (courier или TCG locker) и при необходимости название. Добавьте способ второй раз для другого типа доставки.

Настройка

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

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

Delivery type (zone): Courier to the door (по умолчанию) или TCG locker (customer chooses a locker). Добавьте способ дважды, чтобы предложить оба варианта. Для постаматов нужен ключ API ShipLogic, и они доступны только в ЮАР.

Каждый раз, когда вы сохраняете настройки, кэшированные тарифы и постаматы очищаются. Предупреждения над настройками сообщают, что магазин не доставляет в ЮАР, не указан ключ API, не заданы курс пересчёта ZAR или адрес отправителя, нет ни таблицы цен, ни резервной стоимости, либо последний запрос к ShipLogic завершился ошибкой (с датой и текстом ошибки).

Общие

Enable/Disable: выключает способ доставки везде, включая зоны доставки.

Method name: название, которое видит покупатель при оформлении заказа. Для доставки в постамат к названию добавляется «locker», например «The Courier Guy locker». Зона может заменить его своим названием. По умолчанию: The Courier Guy.

Tax status: Taxable: тарифы в реальном времени берутся без НДС, а WooCommerce добавляет собственный налог. None: тарифы в реальном времени берутся с НДС.

API ShipLogic (тарифы в реальном времени и постаматы)

API key: ваш ключ API ShipLogic из портала The Courier Guy.

Account ID: необязательно. Числовой ID аккаунта ShipLogic, только если ваш ключ имеет доступ к нескольким аккаунтам.

Тарифы в реальном времени (для адресов в ЮАР; если тариф в реальном времени недоступен, используется таблица цен)

Price source: откуда берётся цена.

ZAR conversion rate: ShipLogic считает в южноафриканских рандах (ZAR). Если валюта вашего магазина не ZAR, укажите, сколько составляет 1 ZAR в валюте вашего магазина, например 0.05. Без этого значения тарифы в реальном времени не используются, и действует таблица цен. Если валюта магазина ZAR, оставьте поле пустым. Курс не обновляется автоматически.

Адрес отправителя (для тарифов в реальном времени) (откуда The Courier Guy забирает посылки в ЮАР; для тарифов в реальном времени нужны улица, город, провинция и почтовый индекс)

Sender company: название вашей компании.

Sender street address: например 12 My Road.

Sender suburb: пригород адреса отправителя.

Sender city: город адреса отправителя.

Sender province: выберите южноафриканскую провинцию из списка.

Sender postal code: почтовый индекс адреса отправителя.

Таблица цен (ваши цены в валюте магазина: используются с Price table only, вне ЮАР и во всех случаях, когда нет тарифа в реальном времени; допускаются десятичная запятая и точка)

Calculation type: относится только к таблице цен. Тариф в реальном времени всегда рассчитывается на весь заказ.

Prices by weight: таблица стран с колонкой Price и весовыми категориями XS (до 1 кг), S (до 2 кг), M (до 3 кг), L (до 5 кг) и XL (свыше 5 кг). Нажмите + Add row, чтобы добавить строку (новая строка начинается с ЮАР), и крестик, чтобы удалить её. Пустая категория или 0 использует колонку Price. Цена 0 означает бесплатную доставку. Строка * Any country применяется к странам без собственной строки и к строке страны без цен.

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

Условия

Min weight (kg): скрывает способ доставки при весе корзины ниже этого значения. 0 означает без ограничения.

Max weight (kg): скрывает способ доставки при весе корзины выше этого значения. По умолчанию: 30. 0 означает без ограничения.

Minimum order amount: показывает способ доставки только от этой суммы корзины. Оставьте поле пустым, чтобы показывать его всегда.

Free shipping from: сумма корзины, начиная с которой этот способ доставки бесплатный. Бесплатная доставка предлагается только там, где у способа есть цена для адреса назначения: тариф в реальном времени, цена из таблицы или Fallback cost. Если в таблице или в Fallback cost есть цена, запрос к ShipLogic за тарифом не отправляется. Оставьте поле пустым, чтобы никогда не предлагать бесплатную доставку.

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

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

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

Delivery type without zones: courier или TCG locker для этого режима. Используется только вместе с Ignore shipping zones.

Countries: страны назначения для этого режима. Оставьте поле пустым, чтобы использовать все страны, в которые вы доставляете. Постаматы предлагаются только в ЮАР.

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

Debug log: записывает отладочные сообщения в WooCommerce > Status > Logs, источник vfd-the-courier-guy. Ошибки API записываются всегда, даже когда эта опция выключена. Ключ API и данные покупателей никогда не записываются в журнал.

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

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

Когда покупатель вводит адрес доставки, WooCommerce запрашивает у плагина тариф. Плагин сначала проверяет условия: вес корзины, минимальную сумму заказа и исключённые классы доставки. Если применяется бесплатная доставка и для адреса назначения есть цена, способ доставки показывается с ценой 0.

Courier to the door: плагин запрашивает у ShipLogic самый дешёвый сервис от адреса вашего отправителя до адреса покупателя. Сначала должны быть заполнены улица, город, провинция и почтовый индекс покупателя. До этого показывается цена из таблицы.

TCG locker: тариф в реальном времени — это самый дешёвый сервис «от двери до постамата» до постамата, ближайшего к городу покупателя. Он не пересчитывается для постамата, который выбрал покупатель.

Весь заказ рассчитывается как одна посылка: общий вес, наибольшие длина и ширина, а также суммарная высота. Товары без размеров считаются кубами 10 см. Сумма в рандах пересчитывается в валюту вашего магазина. Уровень сервиса, например ECO, сохраняется в строке доставки заказа.

Запросы к ShipLogic прерываются через 12 секунд. Тарифы кэшируются на 1 час, постаматы на 6 часов, ошибки на 10 минут, чтобы медленный API не замедлял каждое обновление оформления заказа. Если тарифа в реальном времени нет, цена берётся из таблицы, затем из Fallback cost. Если не применимо ничего из этого, способ доставки скрывается.

Способ работает при классическом оформлении заказа и в блоках «Корзина» и «Оформление заказа». Он совместим с WooCommerce High-Performance Order Storage (HPOS).

Плагин не оформляет отправления, не создаёт накладные или этикетки и не обновляет отслеживание автоматически. Карты постаматов нет: постаматы выбираются из списка. Тарифы в реальном времени и постаматы работают только в ЮАР. Для других стран используется таблица цен. Для каждой зоны показывается только один тариф (самый дешёвый уровень сервиса), без выбора уровней сервиса, страховки и дополнительных услуг при оформлении заказа.

Пункты выдачи

Когда покупатель выбирает тариф TCG locker при классическом или блочном оформлении заказа, под ним появляется селектор постаматов. В нём перечислены постаматы, которые ShipLogic возвращает для города адреса доставки, сначала ближайшие. Покупатель может ввести другой город, пригород или почтовый индекс и нажать Search. Перед оформлением заказа постамат нужно выбрать.

Постамат повторно проверяется на сервере по списку ShipLogic. Его название и поставщик берутся из ShipLogic, а не из браузера. Выбор сохраняется при обновлениях оформления заказа и сбрасывается при изменении адреса.

Если ShipLogic недоступен, селектор сообщает, что постаматы не удалось загрузить, и заказ можно оформить без постамата. Тогда заказ помечается: «Not chosen — ShipLogic was unavailable at checkout. Agree the locker with the customer.» (Не выбран: ShipLogic был недоступен при оформлении заказа. Согласуйте постамат с покупателем.)

Заказы

Выбранный постамат (название, ID и поставщик) сохраняется в заказе. Он отображается на экране заказа в админке, на страницах «Спасибо за заказ» и «Мой аккаунт», а также в письмах о заказе (HTML и текст). В письме администратору также показан ID постамата.

На экране заказа в админке у заказов этого способа есть поле The Courier Guy tracking reference. Введите номер из вашего портала The Courier Guy и нажмите Save. Номер показывается покупателю на странице заказа и в письмах, отправленных после этого.

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

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

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

Без активного ключа The Courier Guy не показывается покупателям при оформлении заказа. Авторизованные менеджеры магазина по-прежнему видят способ доставки с пометкой (unlicensed — visible to admins only), чтобы вы могли настроить и протестировать плагин до покупки ключа. Напоминание появляется на странице Plugins и на страницах WooCommerce. Существующие заказы не затрагиваются.

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

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

The Courier Guy не отображается при оформлении заказа: проверьте, что лицензия активна, что Enable/Disable включён и способ добавлен в зону страны покупателя (или что включён Ignore shipping zones и страна разрешена). Проверьте ограничения по весу, Minimum order amount и Excluded shipping classes. Убедитесь, что в таблице или в Fallback cost есть цена. Тарифы для постаматов показываются только для адресов в ЮАР.

Покупатели не видят список постаматов: постаматам нужны ключ API, способ зоны с Delivery type «TCG locker» и адрес доставки в ЮАР. На странице настроек показана последняя ошибка ShipLogic, если она есть, например отклонённый ключ.

Цена всегда из таблицы: проверьте предупреждения на странице настроек. Для тарифа в реальном времени нужны ключ API, полный адрес отправителя и, для магазинов не в рандах, курс пересчёта ZAR. Для курьерской доставки должны быть заполнены улица, город, провинция и почтовый индекс покупателя. Для постаматов ShipLogic должен найти постамат рядом с городом покупателя. Включите Debug log и откройте WooCommerce > Status > Logs, источник vfd-the-courier-guy.

ShipLogic недоступен: показывается цена из таблицы или резервная цена. Заказы с постаматом можно оформить без постамата, и они помечаются в заказе.

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

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

Удаление

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

The Courier Guy и ShipLogic являются товарными знаками их владельцев. Этот плагин не связан с The Courier Guy или ShipLogic и не одобрен ими.