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

Требования

PrestaShop: от 8.0 до 9.x. Оформление заказа работает с темами Classic и Hummingbird.

PHP: 8.0 или новее. Модуль не устанавливается на более старые версии PHP.

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

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

Установка

1. В админ-панели перейдите в Modules > Module Manager и нажмите Upload a module. Выберите ZIP-файл модуля.

2. Когда загрузка завершится, нажмите Configure или позже найдите VibeFox Mondial Relay в списке модулей и нажмите Configure.

3. Введите лицензионный ключ VibeFox в поле License key в блоке лицензии в верхней части страницы Configure и нажмите Activate (см. Лицензионный ключ).

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

При установке модуль создаёт перевозчика Mondial Relay Point Relais с текстом срока доставки Delivery to a Mondial Relay Point Relais of your choice. Перевозчик назначается всем группам клиентов и зонам Франции, Бельгии, Люксембурга, Испании, Португалии и Нидерландов. Зоны, группы клиентов, срок доставки, логотип и ограничения размеров можно изменить в Shipping > Carriers. Цены там не задавайте: цена всегда берётся из модуля.

Настройка

Все настройки находятся на странице модуля: Modules > Module Manager > VibeFox Mondial Relay > Configure. У каждого раздела своя кнопка Save, которая сохраняет всю страницу. Каждое сохранение также очищает кешированные списки пунктов выдачи.

Предупреждения в верхней части страницы показывают проблемы, из-за которых перевозчик скрыт: не указан код Enseigne, не указан Private Key в режиме списка, нет цены для Франции, Бельгии или Испании, перевозчик удалён. Значения, которые нельзя сохранить, сообщаются после Save: поле с числом, в котором введено не число (или отрицательное), сохраняет прежнее значение. Название длиннее 64 символов или Min weight (kg) больше Max weight (kg) отклоняются, и ничего не сохраняется. Если единица веса магазина не входит в число известных модулю, предупреждение сообщает, что вес товаров принимается в кг.

Общие

Enable/Disable: включает или выключает Mondial Relay. Это тот же переключатель, что и статус перевозчика в Shipping > Carriers.

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

Tax status: None означает, что цены в таблице окончательные. Вариант Taxable с названием налогового правила означает, что PrestaShop добавляет к ценам налог на доставку по этому правилу.

Аккаунт Mondial Relay

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

Private Key: нужен только для селектора List of nearest points. После сохранения поле остаётся пустым и показывает Saved - leave empty to keep it. Вводите новое значение, только если хотите его изменить. Чтобы удалить сохранённый ключ, отметьте Remove the saved Private Key и нажмите Save. Когда заданы код 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. Если и Price пуста, доставка для этого веса бесплатна, поэтому заполняйте 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 означает без ограничения. Пустое поле означает 30 кг. Оно не может быть меньше Min weight (kg).

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

Ignore shipping zones: предлагать перевозчика для стран, указанных ниже, или для всех поддерживаемых стран, если список пуст, даже там, где зоны перевозчика их не содержат. Пока опция включена, перевозчик привязывается ко всем активным зонам, включая зоны, которые вы создадите позже. Когда вы её выключаете, перевозчик возвращает зоны, которые у него были раньше.

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

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

Debug log: записывает расчёты тарифов и вызовы Web Service в logs/vfd_mrel_debug.log.php в папке модуля. Файл нельзя открыть из браузера. Ошибки всегда записываются, даже если эта опция выключена. Ключи и данные покупателей никогда не записываются.

Log: показывает размер и последние записи журнала. Нажмите Clear log, чтобы его очистить.

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

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

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

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

Если вы измените перевозчика в Shipping > Carriers после того, как у него появились заказы, PrestaShop сохранит его как новую версию перевозчика. Модуль автоматически переходит на новую версию.

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

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

Когда покупатель выбирает перевозчика Mondial Relay на этапе доставки, под ним появляется блок Mondial Relay pickup point.

Режим карты: кнопка 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 секунд. Без почтового индекса покупатель видит Enter your postcode to see the nearest pickup points. Если пункт не найден или список недоступен, покупатель видит сообщение вида «Список пунктов выдачи сейчас недоступен. Пожалуйста, воспользуйтесь картой.», и ему предлагается карта.

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

Когда заказ оформлен, пункт остаётся в заказе. Страница заказа в админ-панели показывает блок Mondial Relay pickup point с названием пункта, адресом и Point Relais number (например FR-066974). Покупатель видит пункт на странице подтверждения заказа и в деталях заказа в своём аккаунте. В письме с подтверждением заказа и в письме о новом заказе модуля Почтовые уведомления пункт добавляется после названия перевозчика.

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

Модуль работает с лицензионным ключом VibeFox с vibefox.net. Блок лицензии License — VibeFox Mondial Relay — это первый блок на странице Modules > Module Manager > VibeFox Mondial Relay > Configure, над настройками. Вставьте ключ в поле License key и нажмите Activate. После этого блок показывает ключ в замаскированном виде, статус (например, дату, до которой действует лицензия, и ваш домен), а также кнопки Check now для повторной проверки статуса, Change key для ввода другого ключа и Remove key для удаления ключа из этого магазина. Ниже находятся строка Product: presta-shipping-mondialrelay и ссылка Manage licenses and domains in your account, которая открывает ваш аккаунт vibefox.net. Изменить ключ могут только сотрудники с правом Configure для модуля. Тексты блока следуют языку панели администратора (включены английский и русский).

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

Один ключ работает на одном домене: домене основного магазина, в том числе при настройке нескольких магазинов. Удаление ключа из магазина не освобождает место для домена. Освободите его в своём аккаунте vibefox.net.

Без активного ключа перевозчик Mondial Relay не показывается покупателям при оформлении, и тариф не рассчитывается. Витрина PrestaShop не знает, что вы вошли в панель администратора, поэтому перевозчик скрыт и для вас: модуль можно настроить до покупки ключа, но протестировать его при оформлении нельзя. Напоминание появляется в Modules > Module Manager на вкладке Alerts. Существующие заказы не затрагиваются.

Когда срок лицензии истекает, модуль продолжает работать, но для обновлений и поддержки нужно продление. Статус автоматически проверяется снова, пока вы работаете в панели администратора: раз в день в течение первых 14 дней после ввода ключа, затем раз в неделю. Задание cron не требуется. Удаление или сброс модуля всегда удаляет лицензионный ключ и статус лицензии.

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

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

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

Список пунктов пуст или недоступен: покупателю сначала нужен почтовый индекс доставки. Если Web Service не работает, вместо списка предлагается карта. Включите Debug log, перезагрузите оформление и посмотрите причину в поле Log на странице модуля.

Карта не открывается: карта загружается с widget.mondialrelay.com и unpkg.com. Проверьте, что блокировщик конфиденциальности или скриптов их не блокирует. Если карту не удаётся загрузить, покупатель видит сообщение «Не удалось загрузить карту Mondial Relay. Повторите попытку позже или выберите другой способ доставки.»

Страница заказа сообщает: No Point Relais was saved for this order: заказ был оформлен без пункта страны доставки. Причина записана в журнал. Попросите покупателя указать Point Relais, прежде чем создавать отправление.

Страница сообщает, что перевозчик Mondial Relay не найден: перевозчик был удалён в Shipping > Carriers. Сбросьте модуль в Modules > Module Manager, чтобы создать его снова.

Удаление

Откройте Modules > Module Manager, откройте меню рядом с VibeFox Mondial Relay и выберите Uninstall. Лицензионный ключ и статус лицензии всегда удаляются. Кешированные списки пунктов выдачи всегда удаляются. Если Remove data on uninstall включено, перевозчик удаляется (история заказов сохраняется), а настройки, журнал и пункты корзин без заказа удаляются. Если выключено, перевозчик только отключается, и все настройки сохраняются. При повторной установке модуля статус перевозчика восстанавливается. Пункты выдачи, сохранённые в заказах, всегда остаются.

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