VibeFox LP Express for WooCommerce — Допомога

Вимоги

WordPress: 5.8 або новіша.

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

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

LP Express: обліковий запис API не потрібен. LP Express не має публічного API тарифів. API Unisend доступне лише клієнтам з договором, і цей плагін його не використовує, тож ви вводите власні (договірні) тарифи. Створюйте посилки у своєму обліковому записі Unisend («Mano siuntos»).

Список терміналів посилок: плагін використовує відкритий список терміналів LP Express, той самий, що використовували старі плагіни LP Express. На момент випуску версії 1.1.0 цей онлайн-список був недоступний. Доки він недоступний, плагін використовує останню завантажену копію, якщо вона є, інакше ваш власний список. Будьте готові ввести власний список (див. Налаштування).

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

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

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

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

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

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

5. Заповніть таблицю тарифів (принаймні один рядок) або запасну вартість. Перевірте рядок статусу про термінали посилок угорі сторінки та додайте власний список терміналів, якщо онлайн-список недоступний.

6. Додайте VibeFox LP Express до своєї зони для Литви в WooCommerce > Settings > Shipping > Shipping zones або увімкніть Ignore shipping zones та оберіть країни.

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

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

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

Угорі сторінки сповіщення показують проблеми та статус терміналів. Червоне сповіщення з'являється, коли не встановлено жодної ціни або немає доступних терміналів посилок, оскільки тоді спосіб не показується під час оформлення замовлення. Інформаційний рядок показує, скільки терміналів посилок у скількох містах доступно і з якого джерела: онлайн-список, збережена копія онлайн-списку (із датою) або ваш власний список.

Загальні

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

Method title: назва способу доставки, яку бачать покупці. Назва способу в зоні її замінює. Типово: LP Express parcel terminal.

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

Ціни (у валюті вашого магазину; десяткові значення можна вводити як 2.99 або 2,99)

Price table: один рядок на країну призначення. Натисніть + Add country, щоб додати рядок, і хрестик (×), щоб видалити його. Оберіть * Any other country для всіх країн без власного рядка. Кожен рядок має Base price та колонки ваги: XS (≤1 kg), S (≤2 kg), M (≤3 kg), L (≤5 kg) і XL (>5 kg). Вага — це вага кошика або вага одного товару при Per item. Порожня колонка використовує базову ціну рядка. 0 означає безкоштовно. Ціни, які не є числами, повідомляються після збереження і залишаються порожніми.

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

Calculation: як розраховується ціна.

Per order (tier by total cart weight): одна ціна на кошик, колонка ваги обирається за загальною вагою кошика. Це типове значення.

Per item (each item priced by its own weight x quantity): кожен товар оцінюється за власною вагою, помноженою на кількість, і ціни додаються.

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

Доступність

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

Maximum weight (kg): приховує спосіб, коли кошик важчий. Термінали LP Express приймають посилки до 30 кг. Типово: 30. 0 — без обмеження.

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

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

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

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

Термінали посилок

Terminal list: звідки беруться термінали.

LP Express online list: онлайн-список завантажується раз на добу. Коли його не вдається завантажити, використовується остання завантажена копія, потім ваш власний список нижче. Це типове значення.

Only my own list: пропонуються лише термінали, які ви введете нижче.

Збереження налаштувань перезавантажує список терміналів.

Додатково

Debug log: записує розрахунок цін і деталі списку терміналів у WooCommerce > Status > Logs (джерело vfd-lp-express). Помилки, наприклад недоступний список терміналів, записуються завжди. Дані покупців не записуються.

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

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

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

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

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

Плагін не запитує тарифи LP Express чи Unisend, не створює відправлень, не друкує етикеток, не викликає кур'єра та не відстежує посилки. Створюйте посилки у своєму обліковому записі Unisend («Mano siuntos»). Кур'єрська доставка до дверей не входить до цього способу.

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

Коли покупець обирає LP Express, під способом доставки з'являються два списки: -- Select city -- і -- Select parcel terminal --. Місто з адреси доставки обирається автоматично, якщо воно збігається з містом у списку. Кожен термінал показується з назвою, адресою та поштовим індексом. Вибір запам'ятовується під час оформлення замовлення, тож він не губиться, коли оформлення оновлюється.

Термінал обов'язковий. У класичному оформленні замовлення покупець бачить Please select an LP Express parcel terminal. У блоковому оформленні замовлення Place order заблоковано, доки не обрано термінал. В обох варіантах оформлення сервер повторно перевіряє термінал за списком, тож підроблений або застарілий ID терміналу відхиляється.

ID, назва та місто терміналу зберігаються в замовленні. Вони показуються на екрані замовлення під адресою доставки (з ID терміналу), на сторінці отриманого замовлення, у розділі My account > Orders та в листах про замовлення (HTML і простий текст) як LP Express parcel terminal.

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

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

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

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

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

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

LP Express не з'являється під час оформлення замовлення: перевірте, що ліцензія активна, що Enable/Disable увімкнено і спосіб додано до зони країни покупця (або що ввімкнено Ignore shipping zones і країна дозволена). Відкрийте сторінку налаштувань: червоне сповіщення пояснить, якщо не встановлено жодної ціни або немає доступних терміналів посилок. Перевірте також обмеження ваги, Minimum cart total і Excluded shipping classes. Коли Debug log увімкнено, WooCommerce > Status > Logs (джерело vfd-lp-express) покаже, чому спосіб було приховано.

Немає терміналів посилок: онлайн-список не вдалося завантажити, і немає ні збереженої копії, ні власного списку. Плагін повторює спробу кожні 15 хвилин. Введіть власний список у Own terminal list або оберіть Only my own list.

Список терміналів застарів: збережіть сторінку налаштувань. Це перезавантажить список терміналів. З власним списком оновлюйте рядки самостійно.

Покупець не може оформити замовлення: потрібно обрати термінал посилок. Якщо покупець бачить «The LP Express parcel terminal list is temporarily unavailable», терміналів зараз немає. Додайте власний список.

У якій валюті ціни: у валюті вашого магазину. Плагін не конвертує валюти.

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

Видалення

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

LP Express — товарний знак його власника. Цей плагін не афілійований з LP Express і не схвалений LP Express.