VibeFox The Courier Guy for WooCommerce — Допомога

Вимоги

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

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

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

Ключ API ShipLogic (для тарифів у режимі реального часу та поштоматів): The Courier Guy працює на платформі ShipLogic. Створіть ключ API у кур'єрському порталі The Courier Guy, у розділі Settings > API Keys (бізнес-акаунт). Без ключа використовується лише таблиця цін, і доставку в поштомат запропонувати не можна.

Доставка в ПАР: тарифи в режимі реального часу та поштомати працюють лише для адрес у ПАР. Ваш магазин має доставляти в ПАР (WooCommerce > Settings > General > Shipping location(s)).

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

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

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

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

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

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

5. Введіть API key ShipLogic. Для тарифів у режимі реального часу заповніть адресу відправника (вулиця, місто, провінція, поштовий індекс) і, якщо валюта вашого магазину не ZAR, — ZAR conversion rate.

6. Заповніть таблицю цін та/або резервну вартість.

7. Додайте VibeFox The Courier Guy до зони доставки для ПАР у розділі WooCommerce > Settings > Shipping > Shipping zones, оберіть Delivery type (courier або TCG locker) і, за бажанням, назву. Додайте спосіб ще раз для іншого типу доставки.

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

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

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

Delivery type (zone): Courier to the door (за замовчуванням) або TCG locker (customer chooses a locker). Додайте спосіб двічі, щоб запропонувати обидва варіанти. Для поштоматів потрібен ключ API ShipLogic, і вони доступні лише в ПАР.

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

Загальні

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

Method name: назва, яку бачить покупець під час оформлення замовлення. Для доставки в поштомат до назви додається «locker», наприклад «The Courier Guy locker». Зона може замінити її власною назвою. За замовчуванням: The Courier Guy.

Tax status: Taxable: тарифи в режимі реального часу беруться без ПДВ, а WooCommerce додає власний податок. None: тарифи в режимі реального часу беруться з ПДВ.

API ShipLogic (тарифи в режимі реального часу та поштомати)

API key: ваш ключ API ShipLogic з порталу The Courier Guy.

Account ID: необов'язково. Числовий ID акаунта ShipLogic, лише якщо ваш ключ має доступ до кількох акаунтів.

Тарифи в режимі реального часу (для адрес у ПАР; якщо тарифу в режимі реального часу немає, використовується таблиця цін)

Price source: звідки береться ціна.

ZAR conversion rate: ShipLogic розраховує в південноафриканських рандах (ZAR). Якщо валюта вашого магазину не ZAR, вкажіть, скільки становить 1 ZAR у валюті вашого магазину, наприклад 0.05. Без цього значення тарифи в режимі реального часу не використовуються, і застосовується таблиця цін. Якщо валюта магазину ZAR, залиште поле порожнім. Курс автоматично не оновлюється.

Адреса відправника (для тарифів у режимі реального часу) (звідки The Courier Guy забирає посилки в ПАР; для тарифів у режимі реального часу потрібні вулиця, місто, провінція та поштовий індекс)

Sender company: назва вашої компанії.

Sender street address: наприклад 12 My Road.

Sender suburb: район адреси відправника.

Sender city: місто адреси відправника.

Sender province: оберіть південноафриканську провінцію зі списку.

Sender postal code: поштовий індекс адреси відправника.

Таблиця цін (ваші ціни у валюті магазину: використовуються з Price table only, поза ПАР і щоразу, коли немає тарифу в режимі реального часу; приймаються десятковий кома або крапка)

Calculation type: стосується лише таблиці цін. Тариф у режимі реального часу завжди розраховується на все замовлення.

Prices by weight: таблиця країн із колонкою Price та ваговими категоріями XS (до 1 кг), S (до 2 кг), M (до 3 кг), L (до 5 кг) і XL (понад 5 кг). Натисніть + Add row, щоб додати рядок (новий рядок починається з ПАР), і хрестик, щоб його видалити. Порожня категорія або 0 використовує колонку Price. Ціна 0 означає безкоштовну доставку. Рядок * Any country застосовується до країн без власного рядка та до рядка країни без жодної ціни.

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

Умови

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

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

Minimum order amount: показує спосіб доставки лише від цієї суми кошика. Залиште поле порожнім, щоб показувати його завжди.

Free shipping from: сума кошика, починаючи з якої цей спосіб доставки безкоштовний. Безкоштовна доставка пропонується лише там, де спосіб має ціну для пункту призначення: тариф у режимі реального часу, ціна з таблиці або Fallback cost. Якщо таблиця або Fallback cost мають ціну, запит до ShipLogic за тарифом не надсилається. Залиште поле порожнім, щоб ніколи не пропонувати безкоштовну доставку.

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

Доступність без зон доставки

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

Delivery type without zones: courier або TCG locker для цього режиму. Використовується лише разом із Ignore shipping zones.

Countries: країни призначення для цього режиму. Залиште поле порожнім, щоб використовувати всі країни, в які ви доставляєте. Поштомати пропонуються лише в ПАР.

Додатково

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

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

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

Коли покупець вводить адресу доставки, WooCommerce запитує в плагіна тариф. Спочатку плагін перевіряє умови: вагу кошика, мінімальну суму замовлення та виключені класи доставки. Якщо діє безкоштовна доставка і для пункту призначення є ціна, спосіб доставки показується з ціною 0.

Courier to the door: плагін запитує в ShipLogic найдешевшу послугу від адреси вашого відправника до адреси покупця. Спершу мають бути заповнені вулиця, місто, провінція та поштовий індекс покупця. Доти показується ціна з таблиці.

TCG locker: тариф у режимі реального часу — це найдешевша послуга «від дверей до поштомата» до поштомата, найближчого до міста покупця. Він не перераховується для поштомата, який обрав покупець.

Усе замовлення розраховується як одна посилка: загальна вага, найбільші довжина й ширина та сумарна висота. Товари без розмірів вважаються кубами 10 см. Сума в рандах перераховується у валюту вашого магазину. Рівень сервісу, наприклад ECO, зберігається в рядку доставки замовлення.

Запити до ShipLogic завершуються через 12 секунд. Тарифи кешуються на 1 годину, поштомати на 6 годин, помилки на 10 хвилин, щоб повільний API не сповільнював кожне оновлення оформлення замовлення. Якщо тарифу в режимі реального часу немає, ціна береться з таблиці, потім з Fallback cost. Якщо жодне з цього не застосовується, спосіб доставки приховується.

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

Плагін не оформлює відправлення, не створює накладних чи етикеток і не оновлює відстеження автоматично. Карти поштоматів немає: поштомати обираються зі списку. Тарифи в режимі реального часу та поштомати працюють лише в ПАР. Для інших країн використовується таблиця цін. Для кожного екземпляра зони показується лише один тариф (найдешевший рівень сервісу), без вибору рівнів сервісу, страхування чи додаткових послуг під час оформлення замовлення.

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

Коли покупець обирає тариф TCG locker у класичному або блоковому оформленні замовлення, під ним з'являється вибір поштомата. Він показує поштомати, які ShipLogic повертає для міста адреси доставки, спочатку найближчі. Покупець може ввести інше місто, район або поштовий індекс і натиснути Search. Поштомат потрібно обрати, перш ніж можна буде оформити замовлення.

Поштомат повторно перевіряється на сервері за списком ShipLogic. Його назва та постачальник беруться з ShipLogic, а не з браузера. Вибір зберігається під час оновлень оформлення замовлення і скидається, коли змінюється адреса.

Якщо ShipLogic недоступний, вибір повідомляє, що поштомати не вдалося завантажити, і замовлення можна оформити без поштомата. Тоді замовлення позначається: «Not chosen — ShipLogic was unavailable at checkout. Agree the locker with the customer.» (Не обрано: ShipLogic був недоступний під час оформлення замовлення. Узгодьте поштомат з покупцем.)

Замовлення

Обраний поштомат (назва, ID та постачальник) зберігається в замовленні. Він відображається на екрані замовлення в адмін-панелі, на сторінках «Дякуємо» та «Мій акаунт», а також у листах про замовлення (HTML і простий текст). Лист адміністратору також показує ID поштомата.

У замовленнях цього способу на екрані замовлення в адмін-панелі є поле The Courier Guy tracking reference. Введіть номер із вашого порталу The Courier Guy та натисніть Save. Номер показується покупцеві на сторінці замовлення та в листах, надісланих після цього.

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

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

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

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

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

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

The Courier Guy не відображається під час оформлення замовлення: переконайтеся, що ліцензія активна, Enable/Disable увімкнено і спосіб доданий до зони країни покупця (або Ignore shipping zones увімкнено, а країна дозволена). Перевірте обмеження за вагою, Minimum order amount і Excluded shipping classes. Переконайтеся, що в таблиці або в Fallback cost є ціна. Тарифи для поштоматів з'являються лише для адрес у ПАР.

Покупці не бачать список поштоматів: для поштоматів потрібні ключ API, спосіб зони з Delivery type «TCG locker» і адреса доставки в ПАР. На сторінці налаштувань показано останню помилку ShipLogic, якщо вона є, наприклад відхилений ключ.

Ціна завжди з таблиці: перегляньте попередження на сторінці налаштувань. Тариф у режимі реального часу потребує ключа API, повної адреси відправника і, для магазинів не в рандах, курсу перерахунку ZAR. Для доставки кур'єром мають бути заповнені вулиця, місто, провінція та поштовий індекс покупця. Для поштоматів ShipLogic має знайти поштомат біля міста покупця. Увімкніть Debug log і відкрийте WooCommerce > Status > Logs, джерело vfd-the-courier-guy.

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

Тарифи виглядають застарілими після зміни: збережіть сторінку налаштувань. Це очистить кешовані тарифи та поштомати.

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

Видалення

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

The Courier Guy і ShipLogic є торговельними марками їхніх власників. Цей плагін не пов'язаний із The Courier Guy чи ShipLogic і не схвалений ними.