VibeFox Mondial Relay for WooCommerce — Помощь

Требования

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

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

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

Аккаунт Mondial Relay: код Enseigne и Private Key выдаются с бизнес-аккаунтом Mondial Relay: см. раздел для профессионалов на mondialrelay.fr, ваш клиентский кабинет «Connect» или ваш менеджер по продажам. Для выбора на карте нужен только код Enseigne. Для списка ближайших пунктов нужны оба. Для тестов Mondial Relay предоставляет код Enseigne BDTEST13 с Private Key PrivateK.

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

Установка

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

2. Нажмите Activate.

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

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

5. Введите код Enseigne и, для режима списка, Private Key. Заполните Country prices.

6. Добавьте VibeFox Mondial Relay в зоны доставки стран, куда вы отправляете заказы, в WooCommerce > Settings > Shipping > Shipping zones, или включите Ignore shipping zones.

Настройка

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

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

Предупреждения вверху страницы показывают проблемы, из-за которых способ доставки скрыт: не указан код Enseigne, не указан Private Key в режиме списка, нет цены для Франции, Бельгии или Испании.

Общие

Enable/Disable: включает или выключает Mondial Relay глобально.

Name: название способа доставки, которое видят покупатели при оформлении заказа. По умолчанию: Mondial Relay Point Relais.

Tax status: Taxable добавляет налог WooCommerce к стоимости доставки, None не добавляет.

Аккаунт Mondial Relay

Brand code (Enseigne): обязательно, до 8 символов, например BDTEST13 для тестов. Используется картой пунктов и Web Service. Без него покупатели не могут выбрать Point Relais, поэтому способ доставки не показывается при оформлении заказа.

Private Key: нужен только для селектора List of nearest points. Если заданы код Enseigne и Private Key, соединение с Web Service Mondial Relay проверяется при каждом сохранении настроек, и сообщение показывает, действительны ли они.

Селектор пункта выдачи

Selector: как покупатель выбирает Point Relais.

Тарифы (в валюте вашего магазина)

Country prices: цена по стране назначения и весу посылки. Нажмите + Add country, чтобы добавить строку, и крестик, чтобы удалить строку. Используйте строку * Default для всех остальных стран. В каждой строке есть Price и колонки веса: XS до 1 кг, S 1-2 кг, M 2-3 кг, L 3-5 кг и XL свыше 5 кг. Если колонка веса пустая или содержит 0, используется колонка Price. Десятичные знаки через точку или запятую (4.90 или 4,90). Строки без цены удаляются при сохранении, а значения, которые не являются числами, сообщаются и остаются пустыми.

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

Calculation type: как рассчитывается цена.

Free shipping from: сумма корзины (после скидок, без налога), начиная с которой доставка бесплатна. Оставьте пустым, если бесплатной доставки нет.

Доступность

Min weight (kg): скрывает способ доставки, если корзина весит меньше. 0 означает без ограничения.

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

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

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

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

Countries (ignore zones): страны назначения для этого режима. Это поле используется только при включённом Ignore shipping zones.

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

Debug log: записывает расчёт тарифов и обращения к Web Service в WooCommerce > Status > Logs (источник vfd-mondialrelay). Ошибки записываются всегда, даже если эта опция выключена. Ключи и данные покупателей не записываются.

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

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

Способ доставки предлагается только для стран с Points Relais: Франция, Бельгия, Люксембург, Испания, Португалия и Нидерланды. Он скрыт, если покупатель не мог бы выбрать пункт: без кода Enseigne или в режиме списка без Private Key.

Когда покупатель вводит адрес доставки, WooCommerce запрашивает у плагина тариф. Плагин проверяет вес корзины, минимальную сумму и исключённые классы доставки. Цена берётся из строки страны (или строки *): колонка веса, иначе Price. Без строки используется запасная стоимость. Если цены нет, способ доставки скрывается. Если сумма достигает Free shipping from, цена становится 0.

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

Плагин не запрашивает тарифы в реальном времени: у Mondial Relay нет публичного API тарифов. Он не создаёт отправления, не печатает этикетки и не отслеживает посылки. Создавайте отправления в своём кабинете Mondial Relay «Connect», используя номер Point Relais, который показан в заказе. Доставка на дом (Domicile) не предлагается.

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

Режим карты: когда покупатель выбирает Mondial Relay, под способом доставки появляется кнопка Choose a Point Relais. Она открывает официальную карту Mondial Relay для страны доставки, почтового индекса и веса посылки. После того как покупатель выбрал пункт, он показывается как Selected:, а кнопка меняется на Change Point Relais. Виджет карты загружается с widget.mondialrelay.com, а её библиотека с unpkg.com, только когда покупатель открывает карту. Упомяните это в политике конфиденциальности.

Режим списка: выпадающий список - Choose a Point Relais - показывает 10 ближайших пунктов для почтового индекса доставки с расстоянием до каждого. Выбранный пункт показывается с часами работы. Список загружается вашим сервером, поэтому в браузере не выполняется сторонних скриптов. Списки кешируются на 12 часов, пустой ответ — на 1 час, а неудачный запрос запоминается на 5 минут. Тайм-аут Web Service составляет 10 секунд. Если список недоступен, покупатель видит «The list of pickup points is not available right now. Please use the map.» и ему предлагается карта.

Пункт обязателен. Без него покупатель видит Please choose a Mondial Relay pickup point. и заказ не оформляется. Пункт в стране, отличной от страны адреса доставки, отклоняется. В режиме списка пункт также проверяется по списку для адреса.

Номер Point Relais, страна, название и адрес сохраняются в заказе. Они показываются на экране заказа под адресом доставки (с номером Point Relais), на странице благодарности, в My account > Orders и в письмах о заказе (HTML и текстовых) как Mondial Relay pickup point.

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

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

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

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

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

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

Mondial Relay не появляется при оформлении заказа: проверьте, что лицензия активна, что Enable/Disable включён и что способ доставки добавлен в зону страны покупателя (или что включён Ignore shipping zones и страна разрешена). Проверьте предупреждения вверху страницы настроек: способ скрыт без кода Enseigne, в режиме списка без Private Key, для страны без цены, за пределами ограничений по весу и сумме, а также для стран без Points Relais.

Проверка Web Service не прошла после сохранения: сообщение показывает ошибку Mondial Relay, например неверный код Enseigne или неверный ключ безопасности. Проверьте код Enseigne и Private Key у Mondial Relay.

Список пунктов пуст или недоступен: покупателю нужно сначала ввести почтовый индекс. Если Web Service не работает, вместо списка предлагается карта. Включите Debug log и откройте WooCommerce > Status > Logs, источник vfd-mondialrelay, чтобы узнать причину.

Карта не открывается: карта загружается с widget.mondialrelay.com и unpkg.com. Проверьте, не блокирует ли их блокировщик приватности или скриптов. Разработчики могут изменить адреса скриптов фильтрами vfd_mrel_widget_script_url, vfd_mrel_leaflet_script_url и vfd_mrel_leaflet_style_url. Список поддерживаемых стран можно изменить фильтром vfd_mrel_supported_countries.

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

Удаление

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

Mondial Relay — товарный знак его владельца. Этот плагин не связан с Mondial Relay и не одобрен Mondial Relay.