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