VibeFox GLS ParcelShop for PrestaShop — Допомога

Вимоги

PrestaShop: 8.0–9.x. Вибір пункту видачі працює в темах Classic і Hummingbird.

PHP: 8.0 або новіша версія. Модуль не встановлюється на старіших версіях PHP.

GLS: модуль не використовує і не потребує облікового запису GLS чи ключа API. Карта пунктів ParcelShop публічна. Для відправлення посилок до обраних пунктів потрібен договір із GLS.

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

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

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

2. Після завершення завантаження натисніть Configure або пізніше знайдіть VibeFox GLS ParcelShop у списку модулів і натисніть Configure.

3. Введіть ліцензійний ключ VibeFox у License key у блоці ліцензії вгорі сторінки Configure і натисніть Activate (див. розділ «Ліцензійний ключ»).

4. Встановіть ціни: принаймні один рядок у Country prices (наприклад, * Default) або Fallback cost (див. розділ «Налаштування»), і натисніть Save.

Під час встановлення модуль створює перевізника GLS ParcelShop з текстом терміну доставки Delivery to a GLS ParcelShop of your choice. Перевізника призначено всім групам покупців і зонам країн карти GLS (у стандартному магазині зазвичай Europe та Europe (non-EU)). Зони, групи покупців, текст строку доставки та логотип можна змінити в розділі Shipping > Carriers. Ціни там не встановлюйте: ціна завжди береться з модуля.

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

Усі параметри розташовано на сторінці модуля: Modules > Module Manager > VibeFox GLS ParcelShop > Configure. Кожен розділ має власну кнопку Save, яка зберігає всю сторінку.

Попередження вгорі сторінки вказують на проблеми з налаштуваннями: перевізника не знайдено, модуль не знає одиницю ваги магазину (встановіть kg, g, lb або oz в International > Localization, Local units), не встановлено жодної ціни, або деякі чи всі вибрані Countries (ignore zones mode) не охоплює карта GLS. Некоректне або від'ємне число відхиляється з повідомленням, яке називає поле, і зберігається попереднє значення. Інші поля все одно зберігаються.

General

У розділі перелічено країни, які охоплює карта GLS. Перевізник не пропонується для інших країн призначення.

Enable/Disable: вмикає або вимикає GLS ParcelShop. Це той самий перемикач, що і статус перевізника в Shipping > Carriers.

Name: назва способу доставки, яку бачить покупець (назва перевізника). За замовчуванням: GLS ParcelShop. Обов'язкове поле, не більше 64 символів.

Tax status: податкове правило перевізника. None означає, що доставка не оподатковується. Виберіть податкове правило, щоб доставка оподатковувалася.

Prices

Ціни вводяться в основній валюті магазину без податків. Десяткові знаки можна вказувати через кому або крапку (4,99 або 4.99). Покупцеві ціна показується у валюті кошика.

Calculation type: спосіб застосування ціни.

Country prices: таблиця з одним рядком для кожної країни призначення. Натисніть Add country, щоб додати рядок, і значок кошика, щоб видалити його. Кожен рядок має Country, Price та п'ять вагових колонок: XS до 1 кг, S 1-2 кг, M 2-3 кг, L 3-5 кг і XL понад 5 кг. Використовується колонка, що відповідає вазі кошика. Вагова колонка, залишена зі значенням 0, використовує колонку Price. Рядок * Default застосовується для країн без власного рядка. Нові рядки починаються з * Default і 0 у всіх колонках, а рядок, де всі ціни 0, дає безкоштовну доставку, тож оберіть країну та заповніть ціни перед збереженням. Якщо якесь значення в таблиці не є допустимим числом, уся таблиця не зберігається, а повідомлення перелічує некоректні значення.

Fallback cost: ціна, яка використовується, коли в таблиці немає рядка для країни призначення і немає рядка * Default. Залиште поле порожнім, щоб приховувати перевізника для таких країн.

Free shipping from: сума кошика (після знижок, без податків), починаючи з якої доставка GLS ParcelShop безкоштовна. Залиште поле порожнім, якщо доставка ніколи не буває безкоштовною.

Availability

Minimum weight (kg): приховує перевізника, якщо кошик важить менше. Вага перераховується з одиниці ваги вашого магазину. Порожнє значення або 0 означає відсутність обмеження.

Maximum weight (kg): приховує перевізника, якщо кошик важить більше. За замовчуванням: 20. Пункти GLS ParcelShop зазвичай приймають посилки до 20 кг, тож перевірте свій договір із GLS. Порожнє значення або 0 означає відсутність обмеження. Якщо мінімум більший за максимум, обидві ваги відхиляються з повідомленням, а попередні значення зберігаються.

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

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

Countries (ignore zones mode): країни призначення для цього режиму. Залиште поле порожнім, щоб використовувати всі країни карти GLS. Країни, яких немає на карті GLS, пропускаються. Це поле використовується лише коли ввімкнено Ignore shipping zones.

Advanced

Debug log: записує розрахунки тарифів і вибір пунктів ParcelShop у файл logs/vfd_glps_debug.log.php у папці модуля. Відкрити файл з веб-браузера не можна. Помилки завжди записуються. Персональні дані покупців не записуються. Вимкніть журнал, коли закінчите.

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

Remove data on uninstall: коли ввімкнено, видалення модуля стирає налаштування, перевізника та журнал. Коли вимкнено, усе зберігається для повторного встановлення. Пункт ParcelShop, збережений у замовленнях, завжди зберігається.

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

Коли PrestaShop показує крок доставки, він запитує в модуля ціну GLS ParcelShop. Враховуються лише фізичні товари: віртуальні товари не додають ваги і не входять до суми кошика. Модуль спочатку перевіряє умови: країна доставки охоплюється картою GLS (і вибрана в Countries (ignore zones mode), коли цей режим увімкнено), вага кошика та мінімальна сума кошика. Якщо сума кошика досягає Free shipping from, доставка безкоштовна. Інакше ціна береться з рядка країни (або рядка * Default) і вагової колонки, або з Fallback cost. Якщо ціну не знайдено, перевізника приховують.

Коли покупець обирає GLS ParcelShop, під перевізником з'являється блок GLS ParcelShop з кнопкою Select GLS ParcelShop. Вона відкриває офіційну карту пунктів GLS для країни доставки. Після вибору пункту видачі показуються його назва та адреса, а кнопка змінюється на Change ParcelShop. Вибір зберігається в кошику, тож залишається, коли крок доставки оновлюється або сторінка перезавантажується. Якщо адреса доставки змінюється на іншу країну, покупцеві потрібно знову обрати пункт видачі.

Коли покупець натискає Continue на кроці доставки, модуль перевіряє, що пункт видачі обрано і що він розташований у країні доставки. Інакше покупець бачить Please select a GLS ParcelShop. або The selected GLS ParcelShop is not in your shipping country. Please choose a ParcelShop again. і залишається на кроці доставки. Якщо пункт видачі не вдалося зберегти, покупець бачить The ParcelShop could not be saved. Please try again. Якщо скрипт карти GLS не завантажується, покупець бачить повідомлення перезавантажити сторінку або вибрати інший спосіб доставки.

Карта GLS працює в браузері покупця. Під час оформлення замовлення модуль завантажує скрипт карти з map.gls-croatia.com, а карта завантажує дані пунктів видачі та фрагменти карти з GLS. GLS отримує звичайні дані запиту відвідувача (IP-адресу, браузер). З вашого сервера в GLS нічого не надсилається.

Якщо ви редагуєте перевізника в Shipping > Carriers після того, як у нього з'явилися замовлення, PrestaShop зберігає його як нову версію перевізника. Модуль автоматично переходить на нову версію.

Модуль не отримує актуальних тарифів GLS, не створює відправлень GLS, не друкує етикетки та не відстежує посилки. На вашому сервері немає списку пунктів видачі, тому він не може перевірити ID пункту в GLS. Передайте ID пункту видачі із замовлення до GLS звичним для вас способом (MyGLS, ваше програмне забезпечення GLS або інший модуль).

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

Під час оформлення замовлення пункт видачі з кошика зберігається разом із замовленням: його ID, назва з адресою та країна. Далі він не змінюється разом із кошиком.

Сторінка замовлення в адмін-панелі: блок GLS ParcelShop показує назву та адресу пункту видачі, а також ParcelShop ID і країну. Якщо в замовлення GLS ParcelShop не вказано пункт видачі, блок показує No ParcelShop was selected for this order.

Сторінки покупця: пункт видачі відображається на сторінці підтвердження замовлення та на сторінці деталей замовлення в особистому кабінеті покупця.

Листи: пункт видачі додається до назви перевізника в листі з підтвердженням замовлення, який отримує покупець. Лист про нове замовлення продавцю (модуль Mail alerts) також містить ID пункту видачі.

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

Модуль працює з ліцензійним ключем VibeFox з vibefox.net. Блок ліцензії License — VibeFox GLS ParcelShop є першим блоком на сторінці Modules > Module Manager > VibeFox GLS ParcelShop > Configure, над налаштуваннями. Введіть ключ у License key і натисніть Activate. Після цього блок показує ключ у прихованому вигляді, статус (наприклад, дату, до якої діє ліцензія, і ваш домен) та кнопки Check now для повторної перевірки статусу, Change key для введення іншого ключа та Remove key для видалення ключа з цього магазину. Нижче розміщено рядок Product: presta-shipping-gls-parcelshop і посилання 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.

Без активного ключа перевізник GLS ParcelShop не показується покупцям під час оформлення замовлення, і тариф не розраховується. Вітрина PrestaShop не знає, що ви ввійшли в адмін-панель, тож перевізник приховано і для вас: ви можете налаштувати модуль до купівлі ключа, але не можете перевірити його під час оформлення замовлення. Нагадування з'являється в Modules > Module Manager на вкладці Alerts. Наявні замовлення не змінюються.

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

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

GLS ParcelShop не з'являється під час оформлення замовлення: перевірте, що ліцензія активна і Enable/Disable увімкнено. У Shipping > Carriers перевірте, що перевізник охоплює зону країни покупця і групу покупця (або ввімкніть Ignore shipping zones і перевірте Countries (ignore zones mode)). Перевірте, що країна призначення є однією з країн карти GLS і має ціну (рядок країни, рядок * Default або Fallback cost). Перевірте обмеження ваги та Minimum cart subtotal. Товари також можуть бути обмежені певними перевізниками на сторінці товару. Увімкніть Debug log і перегляньте поле Log, щоб дізнатися причину.

Карта не відкривається: покупець бачить "The GLS ParcelShop map could not be loaded...", коли скрипт GLS блокується, наприклад блокувальником реклами чи конфіденційності, політикою безпеки вмісту (CSP) або через збій у GLS. Дозвольте map.gls-croatia.com у вашій політиці безпеки вмісту.

Доставка для країни безкоштовна помилково: перевірте рядок цієї країни в Country prices. Рядок, де Price і всі вагові колонки дорівнюють 0, дає безкоштовну доставку.

Таблицю або поле не збережено: значення не є допустимим числом. Повідомлення вгорі сторінки називає значення. Використовуйте цифри з комою або крапкою як десятковим роздільником.

Сторінка повідомляє, що перевізника GLS ParcelShop не знайдено: перевізника видалено в Shipping > Carriers. Скиньте модуль у Modules > Module Manager, щоб створити його знову. Reset зберігає статус наявного перевізника: вимкнений перевізник залишається вимкненим.

У замовлення немає пункту видачі, а в журналі сказано, що пункт ParcelShop з кошика вже збережено в іншому замовленні: один кошик перетворився на два замовлення. Перше замовлення зберігає пункт видачі. Передайте друге замовлення до GLS вручну.

Видалення

Перейдіть до Modules > Module Manager, відкрийте меню поруч із VibeFox GLS ParcelShop і виберіть Uninstall. Ліцензійний ключ і статус ліцензії завжди видаляються.Якщо Remove data on uninstall увімкнено, перевізника видаляють (замовлення зберігають історію), а також видаляють налаштування, журнал і пункти ParcelShop кошиків без замовлення. Якщо вимкнено, перевізника лише вимикають, і всі налаштування зберігаються. Після повторного встановлення модуля збережений перевізник отримує свій попередній статус. Пункт ParcelShop, збережений у замовленнях, завжди зберігається.

GLS є торговельною маркою її власника. Цей модуль не пов'язаний з GLS і не схвалений нею.