VibeFox Mondial Relay for OpenCart — Допомога

Вимоги

OpenCart: 3.0.x (перевірено на 3.0.5.0) або 4.0.2 та новіші (перевірено на 4.1.0.3), зі стандартною темою.

PHP: 8.0 або новіша версія.

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

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

Встановлення

Завантаження — це один zip-файл із пакетами для обох версій OpenCart. Розпакуйте його на своєму комп'ютері. Він містить README.txt, пакет для OpenCart 3 vfd_mondialrelay-oc3-(version).ocmod.zip і пакет для OpenCart 4 vfd_mondialrelay.ocmod.zip. Встановлюйте лише пакет для вашої версії OpenCart. Ліцензійний ключ однаковий для обох версій.

OpenCart 3

1. В адмін-панелі перейдіть до Extensions > Installer, натисніть Upload і виберіть файл vfd_mondialrelay-oc3-(version).ocmod.zip. Розширення не додає модифікацій OCMOD, тож оновлювати Extensions > Modifications не потрібно. Замість Installer можна скопіювати вміст папки upload з пакета в кореневу папку магазину.

2. Перейдіть до Extensions > Extensions і виберіть тип розширення Shipping. Знайдіть VibeFox Mondial Relay і натисніть Install (зелена кнопка +).

3. Натисніть Edit (кнопка з олівцем), щоб відкрити сторінку налаштувань.

4. Введіть ліцензійний ключ VibeFox у License key у блоці ліцензії у верхній частині сторінки Edit і натисніть Activate (див. Ліцензійний ключ).

5. Введіть код бренду (Enseigne) і, для режиму списку, приватний ключ. Заповніть Country prices (наприклад, рядок для Франції) або Fallback cost, увімкніть Enable/Disable і натисніть Save.

OpenCart 4

1. В адмін-панелі перейдіть до Extensions > Installer, натисніть Upload і виберіть файл vfd_mondialrelay.ocmod.zip. Не перейменовуйте файл: OpenCart 4 бере код розширення з назви файлу, і перейменований пакет не працює.

2. Пакет з'являється у списку встановлених розширень на тій самій сторінці. Натисніть Install (зелена кнопка +) поруч із ним.

3. Перейдіть до Extensions > Extensions і виберіть тип розширень Shipping. Знайдіть VibeFox Mondial Relay, натисніть Install (зелена кнопка +), а потім Edit (кнопка з олівцем).

4. Введіть ліцензійний ключ і налаштування так само, як у кроках 4 і 5 для OpenCart 3. Сторінка налаштувань і її поля однакові в обох версіях.

Після встановлення спосіб доставки вимкнений, доки ви не увімкнете Enable/Disable і не збережете налаштування. Якщо ви встановлюєте розширення знову після видалення, збережені налаштування використовуються знову.

Налаштування

Усі налаштування розташовані на сторінці розширення: Extensions > Extensions > Shipping > VibeFox Mondial Relay > Edit. Розділи перелічено ліворуч. Одна кнопка Save зберігає всю сторінку без перезавантаження. Кожне збереження також очищає кешовані списки пунктів. Зберігати налаштування можуть лише адміністратори з правом зміни для цього розширення.

Попередження у верхній частині сторінки показують проблеми, через які спосіб доставки приховано: немає коду бренду, немає приватного ключа в режимі списку, немає ціни для Франції, Бельгії чи Іспанії, а також одиниця ваги магазину, яку розширення не знає (тоді ваги товарів беруться в кг). Якщо Name порожнє, довше 64 символів або містить один із символів < > ; = # { }, якщо Min weight (kg) більше за Max weight (kg), або код бренду недійсний, сторінка показує помилку і нічого не зберігається. Числове поле зі значенням, яке не є числом (або від'ємне), позначається після Save і зберігає попереднє значення; решта налаштувань зберігається.

Загальні

Доставка в Point Relais Mondial Relay для Франції, Бельгії, Люксембургу, Іспанії, Португалії та Нідерландів. Спосіб пропонується у своїй географічній зоні (див. Availability) або, з Ignore shipping zones, у перелічених країнах.

Enable/Disable: показує або приховує Mondial Relay під час оформлення замовлення. За замовчуванням: вимкнено.

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

Tax status: None (за замовчуванням) означає, що ціни в таблиці остаточні. Варіант Taxable з назвою класу податку означає, що OpenCart додасть до цін податок на доставку цього класу.

Sort order: місце Mondial Relay серед способів доставки під час оформлення замовлення. Ціле число.

Обліковий запис 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. Коли код бренду і приватний ключ задані, з'єднання з Web Service Mondial Relay перевіряється під час кожного збереження налаштувань, і повідомлення показує, чи вони дійсні.

Вибір пункту видачі

Покупець має обрати Point Relais перед переходом до кроку оплати. Пункт зберігається в замовленні.

Вибір: як покупець обирає Point Relais.

Тарифи (у валюті магазину за замовчуванням, без податку)

Mondial Relay не має публічного API тарифів: ціна береться з цієї таблиці.

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 кг.

Minimum subtotal: показує спосіб доставки, лише якщо проміжна сума кошика (товари, що потребують доставки, після знижок, без податку) не менша за цю суму. Залиште порожнім, щоб показувати завжди.

Geo zone: пропонує спосіб доставки лише для адрес у цій географічній зоні. All zones (за замовчуванням) означає скрізь. Географічні зони керуються в System > Localisation > Geo Zones. Не перевіряється, якщо увімкнено Ignore shipping zones.

Ignore shipping zones: якщо увімкнено, Geo zone не перевіряється: спосіб доставки пропонується лише в країнах, зазначених нижче, або у всіх підтримуваних країнах, якщо список порожній.

Countries (ignore zones): країни призначення для цього режиму. Це поле використовується лише тоді, коли увімкнено Ignore shipping zones. У списку лише країни з Points Relais.

Додатково

Debug log: записує розрахунки тарифів, звернення до Web Service і вибір пунктів у storage/logs/vfd_mrel_debug.log.php (в OpenCart 4 — system/storage/logs/vfd_mrel_debug.log.php). Файл не можна прочитати з веб-браузера. Помилки завжди записуються, навіть якщо цю опцію вимкнено. Ключі та дані покупців ніколи не записуються. Коли файл досягає 5 МБ, його переміщують до vfd_mrel_debug.old.log.php і починають новий журнал.

Log: показує розмір і останні записи журналу налагодження. Натисніть Clear log, щоб очистити його.

Remove data on uninstall: якщо увімкнено, під час видалення розширення видаляються налаштування та журнал. Якщо вимкнено (за замовчуванням), вони зберігаються для повторного встановлення. Кешовані списки пунктів завжди видаляються. Пункти видачі, збережені в замовленнях, залишаються.

Імпорт / Експорт

Export: натисніть Download JSON, щоб зберегти налаштування у файл JSON, без приватного ключа.

Import: вставте раніше експортований JSON і натисніть Import, щоб відновити налаштування, наприклад в іншому магазині. Застосовуються ті самі перевірки, що й під час Save. Збережений приватний ключ залишається.

Як це працює під час оформлення замовлення

Спосіб доставки пропонується лише для країн з Points Relais: Франція, Бельгія, Люксембург, Іспанія, Португалія та Нідерланди. Він приховується, коли покупці не могли б обрати пункт: без коду бренду або в режимі списку без приватного ключа. Якщо задано Geo zone і адреса поза нею, спосіб доставки не пропонується. Коли увімкнено Ignore shipping zones, географічна зона не перевіряється, і обслуговуються лише країни з цього списку (усі підтримувані країни, якщо список порожній).

Коли OpenCart показує способи доставки, він запитує у розширення ціну. Враховуються лише товари з Requires Shipping, встановленим у Yes: інші товари не додають ваги і не входять до проміжної суми. Ваги товарів переводяться з класу ваги OpenCart у кг. Проміжна сума — це ціна товарів, що потребують доставки, після знижки за купоном і до податку. Розширення перевіряє вагу кошика та мінімальну проміжну суму. Ціна береться з рядка країни (або рядка *): колонка ваги, інакше Price. Без рядка використовується резервна вартість. Якщо ціни немає, спосіб доставки приховується. Якщо проміжна сума досягає Free shipping from, ціна стає 0. Ціна обчислюється у валюті магазину за замовчуванням, округлюється до потрібних знаків і показується у валюті покупця з податком обраного Tax status. Для обчислення ціни запит до Mondial Relay не надсилається.

На OpenCart 4 покупець натискає Choose у блоці способу доставки на сторінці оформлення і вибирає Mondial Relay у вікні Shipping method options. Ціни такі самі, як в OpenCart 3.

Розширення не запитує тарифи в реальному часі: 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. Якщо пункт не знайдено або список недоступний, покупець бачить повідомлення на кшталт «Список пунктів видачі наразі недоступний. Скористайтеся картою.», і йому пропонується карта.

Обраний пункт одразу зберігається для сесії покупця. Пункт обов'язковий. Коли покупець натискає Continue, магазин повторно перевіряє пункт. Без пункту покупець бачить Please choose a Mondial Relay pickup point. і не може перейти до оплати. Пункт в іншій країні, ніж адреса доставки, відхиляється з повідомленням, що пункт не знаходиться в країні доставки. У режимі списку пункт додатково звіряється зі списком для адреси. Після оформлення замовлення вибір очищується, тож наступний кошик обирає знову.

На OpenCart 4 блок Mondial Relay pickup point з'являється у вікні Shipping method options, під варіантом Mondial Relay, і карта відкривається всередині цього вікна. Клавіша Escape закриває лише карту. Кнопка Continue вікна не переходить далі без дійсного пункту, з тими самими повідомленнями.

Коли замовлення оформлено, пункт залишається пов'язаним із ним. Спосіб доставки замовлення показує назву способу, а далі назву, адресу та номер пункту, наприклад Mondial Relay Point Relais: TABAC DU LOUVRE, 12 RUE DE RIVOLI, 75001 PARIS (FR-066974), тож покупець бачить це в листі про замовлення та в історії замовлень свого облікового запису. Лист магазину про нове замовлення показує пункт із номером у блоці коментаря. В Sales > Orders сторінка замовлення показує панель Mondial Relay pickup point з назвою пункту, адресою та номером Point Relais, або No Point Relais was saved for this order. На OpenCart 4 панель показується над History. OpenCart 4 зберігає одне замовлення для оформлення і оновлює його щоразу, коли покупець підтверджує знову, і пункт замовлення оновлюється разом із ним. Якщо покупець переводить це замовлення на інший спосіб доставки, його пункт видаляється.

Ліцензійний ключ

Розширення працює з ліцензійним ключем VibeFox з vibefox.net. Блок ліцензії License — VibeFox Mondial Relay — це перший блок на сторінці Extensions > Extensions > Shipping > VibeFox Mondial Relay > Edit, над налаштуваннями. Введіть ключ у License key і натисніть Activate. Після цього блок показує ключ замаскованим, статус (наприклад, дату, до якої ліцензія дійсна, і ваш домен) та кнопки Check now, щоб перевірити статус знову, Change key, щоб ввести інший ключ, і Remove key, щоб видалити ключ із цього магазину. Нижче є рядок Product: opencart-shipping-mondialrelay і посилання Manage licenses and domains in your account, яке відкриває ваш обліковий запис vibefox.net. Змінювати ключ можуть лише адміністратори з правом зміни для розширення. Тексти блоку відповідають мові адмін-панелі (включено англійську та російську).

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

Один ключ працює на одному домені: адреса магазину з конфігурації OpenCart. Видалення ключа з магазину не звільняє його слот домену. Звільніть слот у своєму обліковому записі vibefox.net.

Без активного ключа спосіб доставки Mondial Relay не показується покупцям під час оформлення замовлення, і тариф не розраховується. Адміністратор, який увійшов в адмін-панель у тому самому браузері, усе ще бачить спосіб доставки в магазині, позначений як (unlicensed — visible to admins only), тож ви можете налаштувати та протестувати розширення до купівлі ключа. На OpenCart 4 такого попереднього перегляду немає: магазин не бачить вхід адміністратора, тому без активного ключа спосіб доставки приховано для всіх. Після того як ви один раз відкрили сторінку Edit, на адмін-панелі Dashboard з'являється нагадування. Закрийте його кнопкою ×, щоб приховати на 7 днів. Наявні замовлення не змінюються.

Коли ліцензія спливає, розширення продовжує працювати, але для оновлень і підтримки потрібне продовження. Статус автоматично перевіряється знову, коли ви відкриваєте адмін-панель Dashboard або сторінку Edit: раз на добу протягом перших 14 днів після введення ключа, далі раз на тиждень. Cron-завдання не потрібне. Видалення розширення завжди видаляє ліцензійний ключ і статус ліцензії.

Усунення несправностей

Mondial Relay не з'являється під час оформлення замовлення: перевірте, що ліцензія активна і Enable/Disable увімкнено. Перевірте Geo zone або Ignore shipping zones і список країн. Перевірте попередження у верхній частині сторінки розширення: спосіб приховано без коду бренду, у режимі списку без приватного ключа, для країни без ціни, поза межами ваги та проміжної суми, а також для країн без Points Relais. Перевірте, що в товарів Requires Shipping встановлено Yes.

Перевірка Web Service після збереження не пройшла: повідомлення показує помилку Mondial Relay, наприклад недійсний код бренду або недійсний ключ безпеки. Перевірте код бренду та приватний ключ у Mondial Relay.

Список пунктів порожній або недоступний: покупцю спочатку потрібен поштовий індекс доставки. Якщо Web Service не працює, натомість пропонується карта. Увімкніть Debug log, оновіть сторінку оформлення замовлення і перегляньте причину в полі Log на сторінці розширення.

Карта не відкривається: карта завантажується з widget.mondialrelay.com і unpkg.com. Перевірте, що їх не блокує блокувальник конфіденційності чи скриптів або політика безпеки контенту (Content Security Policy) вашого магазину. Якщо карту не вдається завантажити, покупець бачить «Не вдалося завантажити карту Mondial Relay. Спробуйте пізніше або оберіть інший спосіб доставки.»

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

Сторінка показує "Warning: You do not have permission to modify VibeFox Mondial Relay!": ваша група адміністраторів може лише переглядати налаштування. Надайте групі право зміни для extension/shipping/vfd_mondialrelay (OpenCart 3) або extension/vfd_mondialrelay/shipping/vfd_mondialrelay (OpenCart 4) у System > Users > User Groups.

Видалення

Перейдіть до Extensions > Extensions, виберіть тип Shipping і натисніть Uninstall (червона кнопка −) поруч із VibeFox Mondial Relay. Ключ ліцензії та статус ліцензії цього розширення завжди видаляються. OpenCart завжди скидає Enable/Disable, Sort order, Tax status і Geo zone. Кешовані списки пунктів видачі завжди видаляються. Якщо Remove data on uninstall увімкнено, видаляються також інші налаштування та журнал налагодження. Якщо вимкнено, вони зберігаються і використовуються знову, коли ви встановлюєте розширення повторно. Пункти видачі, збережені в замовленнях, завжди зберігаються, а існуючі замовлення зберігають свій спосіб доставки та вартість.

На OpenCart 4, щоб також видалити файли розширення, після видалення перейдіть до Extensions > Installer, натисніть Uninstall (помаранчева кнопка −) поруч із VibeFox Mondial Relay у списку встановлених розширень, а потім Delete (червона кнопка з кошиком), щоб видалити завантажений пакет.

Mondial Relay є торговельною маркою її власника. Це розширення не пов'язане з Mondial Relay і не схвалене нею.