VibeFox DHL Packstation for WooCommerce — Допомога

Вимоги

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

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

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

DHL API key: список пунктів надходить із безкоштовного API DHL Location Finder. Зареєструйтеся на порталі розробників DHL (developer.dhl.com), створіть застосунок, додайте API «Location Finder - Unified» і скопіюйте API-ключ застосунку. Для цього API не потрібен комерційний договір з DHL. Без ключа спосіб доставки приховано на оформленні замовлення. Зважайте на ліміт запитів вашого застосунку DHL: кожен новий пошук за індексом або містом — це один запит до API.

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

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

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

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

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

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

5. Вставте API-ключ DHL, збережіть, натисніть Test API key, оберіть типи пунктів і введіть ціни за країнами (див. Налаштування).

6. Додайте DHL Packstation до зони доставки (наприклад Німеччина) у WooCommerce > Settings > Shipping > Shipping zones або увімкніть Ignore shipping zones.

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

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

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

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

Загальні

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

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

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

DHL Location Finder API

DHL API key: API-ключ вашого застосунку на developer.dhl.com. Без нього спосіб доставки приховано на оформленні замовлення.

Connection test: кнопка Test API key шукає пункти поблизу 53113 Bonn збереженим ключем і очищає кеш пунктів. Спочатку збережіть налаштування. Показує, скільки пунктів знайдено, або що DHL відхилив ключ (401/403).

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

Location types: які пункти DHL може обрати покупець: Packstation (parcel locker), Post Office (Postfiliale) і DHL Parcel Shop (Paketshop). За замовчуванням усі три. Якщо не вибрано жодного, спосіб приховано. Для Packstation покупець має ввести свій DHL Postnummer.

Search radius (meters): радіус навколо шуканого індексу або міста. За замовчуванням: 5000. DHL дозволяє до 25000 м.

Max results: максимальна кількість пунктів, що показуються за один пошук. За замовчуванням: 20. DHL дозволяє до 50.

Shipping address: використовувати обраний пункт як адресу доставки замовлення. Увімкнено за замовчуванням. Рядок адреси 1 стає, наприклад, «Packstation 105», рядок 2 — «Postnummer» з номером, а також індекс і місто пункту, щоб етикетки, надруковані із замовлення, потрапляли за потрібною адресою. Postnummer також зберігається як _shipping_dhl_postnum — поле, яке читає офіційний плагін «DHL Shipping Germany for WooCommerce».

Ціни

Country prices: ціна за країною призначення у валюті магазину у форматі CC:ЦІНА, через коми або з нового рядка. За замовчуванням: DE:4.99, AT:5.99. Працює й десяткова кома (DE:4,99).

Other countries: ціна для країни призначення, якої немає в Country prices. За замовчуванням: 5.99. Залиште порожнім, щоб приховати спосіб для таких країн.

Calculation: Per order стягує ціну один раз. Per item (price x quantity) множить її на кількість товарів у кошику.

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

Доступність

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

Max weight (kg): спосіб приховано, якщо вага кошика більша за це значення. За замовчуванням: 31.5, оскільки Packstation приймає посилки до 31,5 кг. 0 означає без обмеження.

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

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

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

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

Додатково

Debug log: записує запити до API та кроки оформлення замовлення в WooCommerce > Status > Logs, джерело vfd-dhl-packstation. Помилки API записуються завжди, навіть якщо опцію вимкнено. API-ключ, Postnummer і адреси покупців ніколи не записуються в журнал.

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

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

Коли покупець вводить адресу доставки, WooCommerce запитує в плагіна ціну. Плагін перевіряє вагу кошика, мінімальну суму та виключені класи доставки, бере ціну для країни призначення (або ціну для інших країн) і застосовує безкоштовну доставку, якщо сума кошика достатня.

Спосіб працює при класичному оформленні замовлення та в блоках «Кошик» і «Оформлення замовлення». Він сумісний з WooCommerce High-Performance Order Storage (HPOS).

Плагін не створює відправлень DHL, не друкує етикетки та не відстежує посилки. Скористайтеся порталом для корпоративних клієнтів DHL або плагіном для етикеток: замовлення вже містить адресу Packstation і Postnummer у потрібному їм форматі. Плагін не розраховує тарифи DHL у реальному часі та не показує карту. Якщо API DHL недоступний, покупець бачить повідомлення і не може скористатися цим способом, доки API знову не запрацює. Ручне введення номера Packstation не передбачено.

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

Коли покупець обирає DHL Packstation, під варіантом доставки з'являється вибір пункту. Завантажуються пункти DHL поблизу індексу або міста доставки. Покупець може шукати інший індекс або місто. Пункти групуються за типом (Packstation, Post Office, Parcel Shop) і сортуються за відстанню.

Для Packstation покупець має ввести DHL Postnummer — свій 6–12-значний номер клієнта DHL з додатку DHL або облікового запису DHL. Для інших пунктів він необов'язковий. Замовлення не можна оформити без пункту видачі або з недійсним Postnummer. Це перевіряється на сервері, зокрема для оформлення в блоках.

Результати пошуку кешуються на 12 годин. Невдалий пошук кешується на 10 хвилин, щоб оформлення замовлення не чекало на DHL при кожному оновленні. Тайм-аут API — 12 секунд.

Пункт (ID, тип, номер, назва, адреса) і Postnummer зберігаються в замовленні. Їх показано на екрані замовлення під адресою доставки, на сторінці подяки, у My account > Orders та в листах про замовлення (HTML і текстова версія) як DHL pickup location і DHL Postnummer.

На екрані замовлення натисніть Edit поруч із пунктом, шукайте за індексом або містом, оберіть інший пункт, змініть Postnummer і натисніть Save location. Кожна зміна додає примітку до замовлення. Якщо ввімкнено Shipping address, оновлюється і адреса доставки. Перезавантажте сторінку, щоб побачити зміни.

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

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

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

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

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

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

DHL Packstation не з'являється на оформленні замовлення: перевірте, що ліцензія активна, що Enable/Disable увімкнено і спосіб додано до зони країни покупця (або увімкнено Ignore shipping zones і країна дозволена). Перевірте, що DHL API key заповнено, вибрано принаймні один тип пункту, у країни призначення є ціна (або задано Other countries), а правила ваги, суми та класу доставки не приховують спосіб.

Пункти не відображаються: натисніть Test API key. Якщо DHL відхиляє ключ (401/403), перевірте ключ і те, що у вашому застосунку є API «Location Finder - Unified». Увімкніть Debug log і відкрийте WooCommerce > Status > Logs, джерело vfd-dhl-packstation. Перевірте, що ліміт запитів вашого застосунку DHL не вичерпано.

Немає пунктів поблизу адреси: збільште Search radius (meters) або Max results чи дозвольте покупцеві шукати інший індекс або місто.

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

Видалення

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

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