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

Вимоги

WordPress: 5.8 або новіша версія.

WooCommerce: 7.0 або новіша версія, встановлений і активний. Без нього плагін не активується.

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

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

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

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

1. У WordPress перейдіть до Plugins > Add New > Upload Plugin, оберіть ZIP-файл плагіна та натисніть Install Now. Також можна завантажити папку vfd_packeta до /wp-content/plugins/ через FTP.

2. Натисніть Activate.

3. Відкрийте налаштування: WooCommerce > Settings > Shipping > VibeFox Packeta або натисніть Settings під назвою плагіна на сторінці Plugins.

4. Введіть ліцензійний ключ VibeFox у блоці ліцензії вгорі сторінки та натисніть Activate.

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

6. Додайте VibeFox Packeta до зон доставки для Чехії, Словаччини, Угорщини або Румунії у розділі WooCommerce > Settings > Shipping > Shipping zones або увімкніть Ignore shipping zones.

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

Усі налаштування розташовані на одній сторінці: WooCommerce > Settings > Shipping > VibeFox Packeta. Вони діють для всіх зон доставки. Коли ви додаєте спосіб до зони, вікно зони містить лише одне поле:

Title (zone): назва, яку покупці бачать у цій зоні. Залиште порожнім, щоб використовувати загальну Name.

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

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

Загальні

Enable/Disable: вмикає або вимикає спосіб одразу у всіх зонах.

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

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

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

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

Tax status: Taxable додає податок WooCommerce до вартості доставки, None не додає.

Ціни

У 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, що означає безкоштовну доставку. Оберіть країну та введіть ціни перед збереженням або видаліть рядок. Якщо одна країна є в двох рядках, під час збереження залишається лише перший.

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

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

Доступність

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

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

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

Excluded shipping classes: приховує спосіб, якщо в кошику є товар з будь-якого з цих класів доставки WooCommerce.

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

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

Додатково

Debug log: записує розрахунки тарифів і вибір пунктів видачі в WooCommerce > Status > Logs (джерело «vfd-packeta»). Персональні дані покупців і API-ключ не записуються. Невдалі перевірки API-ключа завжди записуються. Вимкніть журнал, коли закінчите.

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

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

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

Коли покупець обирає спосіб 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.»

Спосіб працює на класичному оформленні замовлення та в блоках Cart і Checkout. Він сумісний із високопродуктивним зберіганням замовлень WooCommerce (HPOS).

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

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

Пункт видачі обов'язковий. Якщо покупець оформлює замовлення без вибору пункту, оформлення зупиняється з повідомленням «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 з назвою, адресою, Pickup point ID та країною під адресою доставки. Якщо в замовленні Packeta немає пункту, екран показує «No pickup point was selected for this order.».

Сторінка подяки та перегляд замовлення: Packeta pickup point: з назвою та адресою.

Листи про замовлення: назва й адреса пункту в HTML- та текстових листах. Листи адміністратору також містять Pickup point ID.

У базі даних пункт зберігається в метаданих замовлення _vfd_pckt_point_id, _vfd_pckt_point_name (назва та адреса) і _vfd_pckt_point_country.

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

Плагін працює з ліцензійним ключем VibeFox з vibefox.net. Блок ліцензії розташований угорі сторінки WooCommerce > Settings > Shipping > VibeFox Packeta. Вставте ключ у поле License key і натисніть Activate. У блоці показано статус, наприклад дату, до якої ліцензія активна, і ваш домен. Кнопка Check now повторно перевіряє статус, Change key дозволяє ввести інший ключ, а Remove key видаляє його з цього сайту. Посилання Manage licenses and domains in your account відкриває ваш обліковий запис на vibefox.net.

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

Без активного ключа Packeta не показується покупцям на оформленні замовлення. Менеджери магазину, які ввійшли в систему, все одно бачать його, позначеним як (unlicensed — visible to admins only), щоб ви могли налаштувати й протестувати плагін до покупки ключа. Нагадування з'являється на сторінці Plugins і на сторінках WooCommerce. Наявні замовлення не змінюються.

Коли термін ліцензії спливає, плагін продовжує працювати, але оновлення та підтримка потребують продовження. Статус автоматично перевіряється знову у фоновому режимі.

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

Packeta не з'являється на оформленні замовлення: перевірте, що ліцензія активна, Enable/Disable увімкнено, API key введено і країна призначення — CZ, SK, HU або RO. Перевірте, що для країни задано ціну (рядок країни, рядок * Default або Fallback cost), обмеження ваги та проміжної суми, Excluded shipping classes, а також що спосіб додано до відповідної зони (або увімкнено Ignore shipping zones). Сторінка налаштувань угорі показує проблеми конфігурації. Увімкніть Debug log, щоб побачити причину в WooCommerce > Status > Logs.

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

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

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

Інші країни або перевізники: за замовчуванням спосіб працює для CZ, SK, HU та RO. Розробники можуть додати країни фільтром vfd_pckt_countries і передати ID перевізників у віджет фільтром vfd_pckt_widget_options.

Блок ліцензії показує помилку: дотримуйтесь повідомлення в блоці. Наприклад, якщо ключ уже використовується на іншому домені, звільніть місце у своєму обліковому записі на vibefox.net і натисніть Check now. Якщо адреса сайту змінилася, натисніть Check now, щоб активувати ключ для нового домену. Якщо сервер ліцензій недоступний, плагін працює з останнім відомим статусом.

Видалення

Деактивація плагіна зберігає всі дані. Щоб його прибрати, деактивуйте та видаліть його на сторінці Plugins. Ліцензійний ключ і статус ліцензії цього плагіна завжди видаляються разом із збереженою перевіркою API-ключа. Налаштування та способи в зонах видаляються, лише якщо була увімкнена опція Remove data on uninstall. Інакше вони зберігаються для повторного встановлення. Наявні замовлення зберігають свої рядки доставки та збережений пункт видачі.

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