VibeFox DPD Pickup for WooCommerce — Допомога

Вимоги

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

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

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

Облікові дані DPD Baltic (Литва, Латвія, Естонія): список пунктів видачі береться з веб-сервісу DPD Baltic. Вам потрібні ім'я користувача та пароль API, які DPD видає своїм бізнес-клієнтам. Запитайте їх у свого менеджера DPD або в службі підтримки клієнтів DPD вашої країни. Один обліковий запис показує пункти видачі Литви, Латвії та Естонії.

DPD Словаччина: публічний пошук parcelshop DPD Словаччини не потребує облікових даних.

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

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

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

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

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

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

5. Оберіть свій API DPD. Для DPD Литва, Латвія або Естонія введіть ім'я користувача та пароль API. Введіть ціни за країнами та збережіть. Натисніть Refresh pickup points, щоб перевірити з'єднання (див. Налаштування).

6. Додайте VibeFox DPD Pickup до своїх зон доставки в WooCommerce > Settings > Shipping > Shipping zones або увімкніть Ignore shipping zones.

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

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

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

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

Загальні

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

Name: назва способу доставки, яку бачить покупець на сторінці оформлення замовлення. За замовчуванням: DPD Pickup Point.

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

Список пунктів видачі DPD

Пункти видачі завантажуються з DPD і кешуються на 24 години.

DPD API: компанія DPD, у якій відкрито ваш обліковий запис. Балтійські облікові записи використовують веб-сервіс своєї країни.

API username (Baltic): ваше ім'я користувача веб-сервісу DPD Baltic. Для DPD Словаччина не потрібно.

API password (Baltic): ваш пароль веб-сервісу DPD Baltic. Для DPD Словаччина не потрібно.

Pickup points: кнопка Refresh pickup points очищає кеш і одразу завантажує пункти видачі з DPD: Литви, Латвії та Естонії для Baltic API або тестовий пошук у Братиславі для DPD Словаччини. Результат показується окремо для кожної країни. Спочатку збережіть налаштування.

Ціни

Ціни доставки фіксовані для кожної країни, у валюті магазину. Ціни DPD через API не запитуються.

Country prices: один рядок на країну: CC:price, наприклад EE:3.50. Десяткова кома приймається. За замовчуванням: SK:3.50, LT:4.00, LV:4.00, EE:4.00.

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

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

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

Доступність

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

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

Max weight (kg): важчі кошики не бачать цей спосіб. За замовчуванням: 31.5. 0 означає без обмежень. Перевірте обмеження ваги посилок для пунктів видачі та поштоматів DPD Pickup у вашій країні.

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

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

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

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

Вибір пункту видачі

City order: спочатку показувати великі міста (Таллінн, Рига, Вільнюс, Братислава та інші). Увімкнено за замовчуванням.

City list width: ширина списку міст у CSS, наприклад 100% або 300px. За замовчуванням: 100%.

Pickup point list width: ширина списку пунктів видачі у CSS, наприклад 100% або 400px. За замовчуванням: 100%.

Додатково

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

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

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

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

Список пунктів видачі кешується на 24 години. Невдалий запит запам'ятовується на 5 хвилин, тож збій DPD ніколи не сповільнює оформлення замовлення. Тайм-аут API становить 15 секунд.

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

Плагін не запитує ціни у DPD, не створює відправлення DPD, не друкує етикетки, не формує маніфести, не замовляє забір кур'єром, не відстежує посилки та не показує карту. Підтримуються лише веб-сервіс DPD Baltic і пошук parcelshop DPD Словаччини.

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

Коли покупець обирає DPD Pickup, під способом доставки з'являються список міст і список пунктів видачі. Місто з адреси покупця вибрано автоматично. Для DPD Словаччини покупець спочатку вводить місто та поштовий індекс, а потім бачить пункти поблизу. Пункт видачі обов'язковий. Сервер перевіряє, що пункт належить до країни та адреси покупця, тож підроблений або застарілий вибір відхиляється.

Обраний пункт зберігається в замовленні. Він відображається на екрані замовлення під адресою доставки, на сторінці подяки, в розділі My account > Orders і в листах про замовлення (HTML та текстова версія) під назвою DPD pickup point. Назва, збережена в замовленні, береться з DPD, а не з браузера.

На екрані замовлення натисніть Edit поруч із пунктом видачі, оберіть місто та інший пункт. Пункт перевіряється за списком DPD для адреси замовлення. Щоб змінити пункт, замовлення має мати місто та поштовий індекс доставки.

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

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

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

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

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

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

DPD Pickup не з'являється на оформленні замовлення: перевірте, чи активна ліцензія, чи увімкнено Enable/Disable, і чи додано спосіб до зони країни покупця (або чи увімкнено Ignore shipping zones і чи дозволена країна). Перегляньте попередження вгорі сторінки налаштувань і натисніть Refresh pickup points. Перевірте обмеження ваги та проміжної суми, виключені класи доставки і чи має країна ціну (або запасну ціну).

«Login failed» після Refresh pickup points: DPD відхилив облікові дані Baltic, тож пункти видачі не можна завантажити. Перевірте ім'я користувача та пароль API у DPD.

DPD Словаччина не показує пункти: пункти з'являються після того, як покупець вводить місто та поштовий індекс. DPD показує лише пункти в радіусі 50 км від цієї адреси.

Пошук причини: увімкніть Debug log. Кожне рішення записується в WooCommerce > Status > Logs, джерело vfd-dpd-pickup. Помилки API записуються завжди. Імена користувачів і паролі API ніколи не записуються в журнал.

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

Видалення

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

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