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 і не схвалений нею.