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

Вимоги

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

PHP: 8.0 або новіша.

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

Політика безпеки вмісту: якщо ваш магазин надсилає політику безпеки вмісту (Content Security Policy), дозвольте map.gls-croatia.com, звідки завантажується скрипт карти GLS.

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

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

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

OpenCart 3

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

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

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

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

5. Встановіть ціни: принаймні один рядок у Country prices (наприклад * Default) або Fallback cost (див. розділ Налаштування). Увімкніть Enable/Disable і натисніть Save.

OpenCart 4

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

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

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

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

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

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

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

Попередження у верхній частині сторінки, а також після кожного збереження, вказують на проблеми конфігурації: не встановлено жодної ціни, деякі або всі вибрані Countries (ignore zones mode) не охоплені картою GLS, або одиниця ваги магазину не відома розширенню і немає класу ваги в кілограмах (додайте його в System > Localisation > Weight Classes). Некоректне або від'ємне число відхиляється з повідомленням, яке називає поле, наприклад Fallback cost: "abc" is not a valid number of 0 or more - the previous value was kept. Решта полів зберігається. Некоректні Name, порядок сортування, клас податку або географічна зона відхиляються так само.

Загальні

Розділ перелічує країни, охоплені картою GLS: Австрія, Бельгія, Болгарія, Хорватія, Чехія, Данія, Фінляндія, Франція, Німеччина, Греція, Угорщина, Італія, Люксембург, Нідерланди, Польща, Португалія, Румунія, Сербія, Словаччина, Словенія та Іспанія. Спосіб доставки не пропонується для інших країн призначення.

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

Name: назва способу доставки, яку бачить покупець. За замовчуванням: GLS ParcelShop. Обов'язкове поле, не більше 64 символів, без символів < > ; = # { }.

Tax status: None (shipping is not taxed) або клас податку, який застосовується, якщо доставка оподатковується.

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

Ціни

Ціни вводяться у валюті магазину за замовчуванням, без податку. Десяткові знаки можна писати через кому або крапку (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 використовується для країн без власного рядка. Рядок, де всі ціни дорівнюють 0, означає безкоштовну доставку, тож оберіть країну та заповніть ціни перед збереженням. Якщо якесь значення в таблиці не є коректним числом від 0 і більше, уся таблиця не зберігається, а повідомлення перелічує некоректні значення.

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

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

Доступність

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

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

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

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

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

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

Додатково

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

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

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

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

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

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

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

Коли OpenCart показує способи доставки, він запитує в розширення ціну GLS ParcelShop. Якщо задано Geo zone (і Ignore shipping zones вимкнено) і адреса поза нею, спосіб доставки не пропонується. Враховуються лише товари з Requires Shipping, встановленим у Yes: інші товари не додають ваги і не входять до суми кошика. Сума кошика — це ціна цих товарів після знижки за купоном, без податку. Далі розширення перевіряє умови: країна доставки охоплена картою GLS (і вибрана в Countries (ignore zones mode), якщо цей режим увімкнено), вага кошика та мінімальна сума кошика. Якщо сума кошика досягає Free shipping from, доставка безкоштовна. Інакше ціна береться з рядка країни (або рядка * Default) і колонки ваги, або з Fallback cost. Якщо ціну не знайдено, спосіб доставки приховується. Ціна округлюється до знаків після коми валюти магазину за замовчуванням і показується з податком, вибраним у Tax status.

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

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

В OpenCart 4 покупець натискає Choose у блоці способу доставки на сторінці оформлення замовлення і вибирає GLS ParcelShop у вікні Shipping method options. Блок GLS ParcelShop з кнопкою Select GLS ParcelShop з'являється в цьому вікні під способом доставки, а карта GLS відкривається поверх вікна. Кнопка Continue у вікні не переходить далі без дійсного ParcelShop, з тими самими повідомленнями. OpenCart 4 зберігає одне замовлення для оформлення і оновлює його щоразу, коли покупець підтверджує вибір знову, а ParcelShop замовлення оновлюється разом із ним.

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

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

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

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

Shipping method name: ParcelShop додається до назви способу доставки в замовленні, наприклад GLS ParcelShop: name, address (спочатку назва способу доставки, потім ParcelShop) (OpenCart 3 зберігає з неї не більше 128 символів, OpenCart 4 — не більше 255). Тож ParcelShop з'являється в листі з підтвердженням замовлення, надісланому покупцеві, на сторінці замовлення в Order History покупця та в Sales > Orders. OpenCart не показує спосіб доставки на сторінці успішного оформлення замовлення.

Admin order page: в Sales > Orders панель GLS ParcelShop показує назву та адресу ParcelShop, а також ParcelShop ID і країну. Якщо в замовленні GLS ParcelShop немає ParcelShop, панель показує No ParcelShop was selected for this order. Панель лише показує ParcelShop; змінити його там не можна.

Лист продавцю: сповіщення про нове замовлення, яке надходить магазину, містить ParcelShop з його ParcelShop ID у блоці коментарів.

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

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

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

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

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

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

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

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

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

Блок ParcelShop не з'являється під способом доставки: розширення перевірялося зі стандартною темою OpenCart та її оформленням замовлення. Тема або розширення оформлення, яке замінює крок способу доставки, може не показати блок.

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

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

У замовленні написано No ParcelShop was selected for this order: замовлення оформлено без ParcelShop країни доставки. Причина записана в журнал. Попросіть покупця вказати ParcelShop і передайте його GLS вручну.

На сторінці написано «Warning: You do not have permission to modify VibeFox GLS ParcelShop!»: ваша група адміністраторів може лише переглядати налаштування. Надайте групі право змінювати extension/shipping/vfd_gls_parcelshop (OpenCart 3) або extension/vfd_gls_parcelshop/shipping/vfd_gls_parcelshop (OpenCart 4) у System > Users > User Groups.

Для розробників: адресу скрипта карти GLS можна замінити налаштуванням vfd_glps_widget_url; для нього немає поля на сторінці налаштувань.

Видалення

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

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

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