VibeFox Packeta for OpenCart — Допомога

Вимоги

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

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

API-ключ Packeta: його можна знайти в розділі клієнта Packeta (client.packeta.com) у пункті Client support. Він складається з 16 літер і цифр. Віджету він потрібен, щоб відкритися під час оформлення замовлення, тому спосіб доставки показується покупцям лише після введення API-ключа.

Країни: Чехія, Словаччина, Угорщина або Румунія мають бути увімкненими країнами вашого магазину. Вони є в стандартних даних OpenCart. В Угорщині в OpenCart немає регіонів, тому поле регіону в адресі залишається порожнім; це не має значення.

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

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

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

OpenCart 3

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

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

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

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

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

OpenCart 4

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

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

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

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

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

Конфігурація

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

Спосіб пропонується лише для країн власної мережі пунктів видачі Packeta: CZ, SK, HU і RO. Над налаштуваннями сторінка показує результат перевірки API-ключа та попередження про проблеми: немає API-ключа, немає ціни, вибрано країни поза мережею Packeta або одиницю ваги магазину, яку розширення не знає. Попередження оновлюються після кожного збереження.

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

Загальні

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

Name: назва способу доставки, яку бачить покупець. За замовчуванням: Packeta pickup point. Обов'язково, не більше 64 символів.

API key: ваш API-ключ Packeta з client.packeta.com > Client support. Можна також вставити 32-символьний API-пароль: зберігаються лише його перші 16 символів, тобто API-ключ. API-ключ є публічним: він надсилається у браузер покупця для відкриття віджета. Під час збереження нового ключа його перевіряють за carrier feed Packeta, і сторінка показує Packeta API key verified або повідомляє, що Packeta відхилила ключ. Якщо перевірку не вдалося виконати, ключ зберігається і перевіряється знову під час наступного збереження.

Widget language: мова віджета пунктів видачі. Store / visitor language (за замовчуванням) дотримується мови сторінки. Її також можна зафіксувати як чеську, словацьку, угорську, румунську, англійську, німецьку, польську або українську.

Pickup point types: які пункти Packeta пропонує віджет.

Tax status: податковий клас OpenCart, що застосовується до ціни доставки, або None (no tax on shipping) (за замовчуванням).

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

Ціни

Packeta не має публічного API тарифів. Ціни беруться з цієї таблиці та вводяться у валюті магазину за замовчуванням без податків. Покупці, які платять в іншій валюті, бачать перераховану ціну.

Calculation type: Per order (за замовчуванням) стягує ціну один раз. Per item (price x quantity) множить її на кількість товарів, що потребують доставки.

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

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

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

Доступність

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

Maximum weight (kg): приховує спосіб, коли кошик важить більше. За замовчуванням: 15. Пункти видачі та Z-BOX Packeta зазвичай приймають посилки до 15 кг; перевірте свій договір з Packeta. Порожнє або 0 означає без обмеження. Мінімальна вага більша за максимальну відхиляється під час збереження, і обидва попередні значення зберігаються.

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

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

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

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

Додатково

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

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

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

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

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

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

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

Коли OpenCart показує способи доставки, він запитує у розширення ціну Packeta. Якщо задано Geo zone (і вимкнено Ignore shipping zones) і адреса поза нею, Packeta не пропонується. Враховуються лише товари з Requires Shipping, що дорівнює Yes: інші товари не додають ваги і не входять до проміжної суми. Розширення перевіряє умови: країна доставки в мережі Packeta, API-ключ, список країн у режимі ігнорування зон, вага кошика та мінімальна проміжна сума кошика. Проміжна сума — це ціна товарів, що потребують доставки, після знижки за купоном і без податків. Подарункові сертифікати, бонусні бали та кредит магазину не враховуються. Якщо діє безкоштовна доставка, ціна дорівнює 0. Інакше ціна береться з таблиці країн, потім з резервної вартості. Якщо ціни немає, спосіб приховується. Ціна показується покупцеві у його валюті з податком за обраним Tax status.

Під опцією Packeta на кроці способу доставки є кнопка Choose pickup point. Вона відкриває в браузері покупця офіційний віджет Packeta з країною призначення, вагою кошика, обраними типами пунктів і мовою віджета. Після того як покупець обере пункт, його назва та адреса показуються під способом, а кнопка змінюється на Change pickup point. Пункт зберігається для сесії оформлення і залишається при перезавантаженні сторінки. Пункт, обраний для іншої країни, не використовується, якщо адреса доставки змінюється на іншу країну.

Ваш сервер під час оформлення замовлення нічого не запитує в Packeta. Скрипт віджета завантажується з widget.packeta.com лише на сторінці оформлення замовлення. Якщо його заблоковано (блокувальником реклами чи приватності, політикою безпеки вмісту або збоєм Packeta), покупець бачить повідомлення «The Packeta pickup point widget could not be loaded. Please reload the page or choose another shipping method.»

Ціни Packeta не запитуються в реальному часі; вони беруться з вашої таблиці. Розширення не створює відправлень Packeta, не друкує наклейки та не відстежує посилки, а також за замовчуванням не пропонує доставку до дверей чи пункти партнерських перевізників. Передайте ID пункту видачі із замовлення в Packeta звичним способом, наприклад імпортом у client.packeta.com. Кнопка пункту видачі працює зі стандартним оформленням замовлення OpenCart стандартної теми.

На OpenCart 4 покупець натискає Choose у блоці способу доставки на сторінці оформлення і вибирає Packeta у вікні Shipping method options. Кнопка Choose pickup point і вибраний пункт з'являються в цьому вікні під варіантом Packeta, а віджет Packeta відкривається поверх нього. Ціни такі самі, як в OpenCart 3.

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

Пункт видачі обов'язковий. Якщо покупець натискає Continue на кроці способу доставки, не вибравши пункт, крок не завершується, і покупець бачить повідомлення «Please choose a Packeta pickup point.». Якщо обраний пункт знаходиться в іншій країні, ніж адреса доставки, покупець бачить «The selected Packeta pickup point is not in your shipping country. Please choose a pickup point again.». Розширення не перевіряє ID пункту в Packeta; воно лише перевіряє, що пункт обрано і що його країна збігається.

Пункт прив'язується до замовлення під час його створення:

Спосіб доставки замовлення: назва та адреса пункту додаються до назви способу, наприклад Packeta pickup point: <point> (до 128 символів). Покупець бачить це в історії замовлення та в листі про замовлення, а також це друкується в рахунку. Сторінка успішного оформлення замовлення OpenCart не показує спосіб доставки.

Сторінка замовлення в адмінпанелі: відкрийте замовлення в Sales > Orders. Панель Packeta pickup point показує назву та адресу, Pickup point ID і країну. Якщо в замовленні Packeta немає пункту, панель повідомляє: «No pickup point was selected for this order.»

На OpenCart 4 кнопка Continue вікна Shipping method options не переходить далі без пункту, з тими самими повідомленнями. OpenCart 4 зберігає одне замовлення для оформлення і оновлює його щоразу, коли покупець підтверджує знову, і пункт замовлення оновлюється разом із ним. Панель Packeta pickup point на сторінці замовлення в адмінпанелі показується над розділом History.

Пункт зберігається у власній таблиці розширення vfd_pckt_point (сесія оформлення, замовлення, ID пункту, назва та адреса, країна).

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

Розширення працює з ліцензійним ключем VibeFox з vibefox.net. Ліцензійний блок License — VibeFox Packeta є першим блоком на сторінці Extensions > Extensions > Shipping > VibeFox Packeta > Edit, над налаштуваннями. Вставте ключ у поле License key і натисніть Activate. Після цього блок показує ключ прихованим, статус (наприклад, дату, до якої дійсна ліцензія, та ваш домен) і кнопки Check now для повторної перевірки статусу, Change key для введення іншого ключа та Remove key для видалення ключа з цього магазину. Нижче розташовані рядок Product: opencart-shipping-packeta і посилання 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.

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

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

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

Packeta не з'являється під час оформлення замовлення: перевірте, що ліцензія активна, що Enable/Disable увімкнено, що введено API key і що країна доставки — CZ, SK, HU або RO. Перевірте, що для країни задано ціну (рядок країни, рядок * Default або Fallback cost), обмеження за вагою та проміжною сумою, а також Geo zone (або Ignore shipping zones та його країни). Перевірте, що у товарів Requires Shipping дорівнює Yes. Сторінка налаштувань вгорі показує проблеми конфігурації. Увімкніть Debug log, щоб побачити причину в Log (last lines).

Packeta відхилила API-ключ: скопіюйте API-ключ знову з client.packeta.com > Client support і збережіть. До того часу віджет не може відкритися під час оформлення замовлення.

Віджет не відкривається: скрипт Packeta заблоковано блокувальником реклами чи приватності, політикою безпеки вмісту або збоєм Packeta. Дозвольте widget.packeta.com у вашій політиці безпеки вмісту.

Доставка безкоштовна помилково: перевірте в Country prices рядки з Price 0, особливо рядок * Default, доданий через Add country і не заповнений, а також перевірте Free shipping from.

Обмеження ваги або вагові колонки виглядають неправильно: якщо сторінка попереджає про одиницю ваги магазину, використовуйте класи ваги з одиницями kg, g, lb або oz і задайте клас ваги за замовчуванням у System > Settings, вкладка Local. Інші одиниці читаються як кілограми.

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

Для розробників: інші розширення можуть додавати країни, передавати віджету параметри, наприклад ID перевізників, змінювати URL скрипта віджета або його мову через події OpenCart vfd_packeta/countries, vfd_packeta/widget_options, vfd_packeta/widget_url і vfd_packeta/widget_language (тригери з префіксом catalog/, наприклад catalog/vfd_packeta/widget_options).

Видалення

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

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

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