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

Вимоги

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

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

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

Omniva: обліковий запис API не потрібен. Omniva не має публічного API тарифів. API OMX від Omniva доступний лише клієнтам з договором і цим плагіном не використовується, тому ви вводите власні (договірні) тарифи. Реєструйте посилки в бізнес-обліковому записі Omniva.

Parcel machine list: плагін завантажує відкритий файл локацій Omniva з omniva.ee (ключ чи договір не потрібні). Ваш сервер має мати змогу надсилати вихідні запити HTTPS до www.omniva.ee.

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

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

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

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

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

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

5. Перевірте ціни за країнами та розмірами посилок, розміри посилок і рядок статусу Parcel machine list.

6. Додайте VibeFox Omniva до зони Естонії, Латвії та/або Литви в WooCommerce > Settings > Shipping > Shipping zones або увімкніть Ignore shipping zones і оберіть країни.

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

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

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

Угорі сторінки сповіщення показують проблеми. Червоне сповіщення з'являється, коли ціна не задана або список поштоматів не вдалося завантажити і немає збереженої копії; тоді метод не показується на оформленні замовлення. Жовте сповіщення з'являється, коли список не вдалося оновити зараз і використовується збережена копія. Числа, які не можна прочитати, повідомляються після збереження і не зберігаються.

Загальні

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

Method title: назва способу доставки, яку бачить покупець. Title методу зони її замінює. За замовчуванням: Omniva parcel machine.

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

Ціни (у валюті вашого магазину; десяткові числа можна писати як 3.50 або 3,50)

Price by parcel size: по одному рядку для кожної країни (Естонія, Латвія та Литва) зі стовпцями S, M, L, XL і Free from. Введіть ціну кожного розміру посилки Omniva для країни призначення. Порожня комірка означає, що цей розмір для країни не пропонується: метод приховується, коли посилка його потребує. 0 означає безкоштовно. Free from — це сума кошика (після знижок, як показано в кошику), починаючи з якої доставка в цю країну безкоштовна; залиште порожнім, якщо безкоштовної доставки немає. Поки ви не збережете власні ціни, таблиця починається з 3.50 для Естонії та 4.00 для Латвії та Литви. Коли податки WooCommerce увімкнено, невелика кнопка -% біля кожної ціни вилучає ПДВ країни вашого магазину з введеної ціни (для цін, які ви знаєте з ПДВ).

Calculation: як визначаються розмір посилки і ціна.

Parcel sizes (cm): максимальні розміри кожного розміру у вигляді Smallest side, Middle side і Largest side. Розміри товару сортуються так само і порівнюються поруч; значення сортуються під час збереження. Розміри товару переводяться з одиниці магазину в см. Товари без розмірів вміщуються в розмір S. Якщо нічого не підходить, метод приховується. За замовчуванням: S 9 x 38 x 64, M 19 x 38 x 64, L 38 x 39 x 64, XL 39 x 64 x 64. Перевірте їх за актуальними розмірами посилок Omniva.

Доступність

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

Maximum weight (kg): приховує метод, коли кошик (або, з Per item, один товар) важчий. Поштомати Omniva приймають посилки до 30 кг. За замовчуванням: 30. 0 означає без обмеження. Одиниця ваги магазину переводиться в кг.

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

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

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

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

Поштомати

Post offices: пропонує також поштові відділення Omniva у тому самому списку. Omniva має поштові відділення в Естонії. За замовчуванням вимкнено.

City order: спочатку показує найбільші міста (Tallinn, Riga, Vilnius та інші), далі решту за алфавітом. За замовчуванням увімкнено. Коли вимкнено, міста сортуються за алфавітом.

Parcel machine list: рядок статусу з кількістю поштоматів за країнами (і поштових відділень, якщо увімкнено) та часом останнього завантаження з omniva.ee. Натисніть Update the list now, щоб завантажити список одразу; якщо omniva.ee не відповідає, зберігається збережена копія.

Додатково

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

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

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

Коли покупець вводить адресу доставки в Естонії, Латвії або Литві, WooCommerce запитує у плагіна тариф. Плагін перевіряє вагу кошика, мінімальну суму кошика та виключені класи доставки, потім визначає розмір посилки за розмірами товару. Якщо посилка не вміщується в жоден розмір, або для розміру немає ціни для країни, або немає доступного поштомата, метод приховується, тож покупець ніколи не бачить оформлення, яке не можна завершити. Якщо сума кошика досягає Free from країни, ціна дорівнює 0. Розмір посилки зберігається в рядку доставки замовлення як Omniva parcel size.

Список поштоматів завантажується з omniva.ee раз на добу і зберігається в базі даних WordPress, а не в папці плагіна. Якщо завантаження не вдалося, працює збережена копія, а наступна спроба відбувається через 15 хвилин, щоб оформлення замовлення не чекало omniva.ee під час кожного оновлення. Тайм-аут завантаження становить 15 секунд.

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

Плагін не запитує тарифи Omniva, не реєструє відправлення, не друкує етикетки, не викликає кур'єра і не відстежує посилки. Реєструйте посилки в бізнес-обліковому записі Omniva. Кур'єрська доставка до дверей не входить до цього методу.

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

Коли покупець обирає Omniva, під методом з'являються два списки: -- Select city -- і -- Select parcel machine --. Показуються лише міста та поштомати країни доставки; коли покупець змінює країну, списки теж змінюються. В Естонії міста є повітами, і Tallinn, Tartu та Pärnu перелічені окремо; в Латвії та Литві це міста і муніципалітети. Місто з адреси доставки попередньо вибирається, якщо воно відповідає місту зі списку. Кожен поштомат показується з назвою та адресою. Вибір запам'ятовується під час оформлення, тож не губиться, коли оформлення оновлюється.

Поштомат обов'язковий. На класичному оформленні покупець бачить Please select an Omniva parcel machine. У блочному оформленні Place order заблоковано, доки не обрано поштомат. В обох випадках сервер ще раз перевіряє поштомат за списком, тож підроблений ID або поштомат іншої країни відхиляється.

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

Щоб змінити поштомат замовлення, відкрийте замовлення в WooCommerce > Orders, натисніть Change поруч із поштоматом, оберіть місто і поштомат країни доставки замовлення та натисніть Save parcel machine. Примітка до замовлення фіксує старий і новий поштомат.

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

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

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

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

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

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

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

Немає поштоматів: список не вдалося завантажити з omniva.ee, і немає збереженої копії. Плагін повторює спробу кожні 15 хвилин. Натисніть Update the list now; якщо не вийшло, перевірте, що ваш сервер може підключитися до www.omniva.ee, і перегляньте помилку на сторінці WooCommerce > Status > Logs.

Немає нового поштомата: список оновлюється раз на добу. Натисніть Update the list now, щоб завантажити його одразу.

Стягується неправильна ціна: ціна залежить від розміру посилки, визначеного за розмірами товару. Перевірте розміри товарів, Calculation і Parcel sizes (cm). З увімкненим Debug log журнал показує обраний розмір і ціну.

Покупець не може оформити замовлення: потрібно обрати поштомат. Якщо покупець бачить повідомлення «The Omniva parcel machine list is temporarily unavailable», поштомати зараз недоступні; див. «Немає поштоматів».

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

Для розробників: фільтр vfd_omniva_locations_url змінює адресу файлу локацій (CSV у форматі Omniva), а vfd_omniva_countries змінює список країн призначення (за замовчуванням EE, LV, LT).

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

Видалення

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

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