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

Вимоги

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

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

PHP: 8.0 або новіша, з розширенням SimpleXML (входить до більшості встановлень PHP).

SmartPost: обліковий запис API і ключ не потрібні. Список пунктів видачі береться з відкритого списку місць SmartPost. У SmartPost немає публічного API тарифів, тому ви вводите власні (договірні) тарифи. Створюйте відправлення в своєму бізнес-акаунті SmartPost (SmartPosti).

Країни: пункти видачі SmartPost є в Естонії, Латвії, Литві та Фінляндії. Для інших країн призначення спосіб доставки не відображається.

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

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

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

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

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

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

5. Перевірте таблицю тарифів (стандартні тарифи вже заповнені), розміри коробок і статус пунктів видачі вгорі сторінки.

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

Конфігурація

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

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

Угорі сторінки повідомлення показують проблеми та статус пунктів видачі. Червоне повідомлення з'являється, коли ціна не задана: тоді спосіб не відображається під час оформлення замовлення. Блок Pickup points available at checkout показує для кожної країни, скільки пунктів видачі й у скількох містах доступно. Він також повідомляє, коли використовується збережена копія списку, бо список SmartPost наразі недоступний, коли країну не вдалося завантажити взагалі та коли для країни не задано тарифів. Кнопка Refresh pickup point lists now завантажує списки знову й показує нові цифри.

Загальні

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

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

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

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

Price table: по одному рядку для кожної країни (Естонія, Латвія, Литва, Фінляндія) з ціною для кожного розміру коробки S, M, L і XL та стовпцем Free from. 0 означає безкоштовно. Порожня клітинка означає, що цей розмір коробки не пропонується: спосіб приховується, коли посилка потребує цю коробку. Країна, у якої всі клітинки порожні, не обслуговується. Free from — сума кошика, починаючи з якої SmartPost безкоштовний у цій країні; залиште порожнім, якщо безкоштовної доставки немає. Ціни, які не є числами, повідомляються після збереження й залишаються порожніми. Стандартні тарифи: Естонія 3.50, Латвія 4.00, Литва 4.00, Фінляндія 5.00 для кожної коробки.

Box sizes (cm): внутрішній розмір кожної коробки, найменша сторона першою (Side 1 (smallest), Side 2, Side 3 (largest)). Сторони товару сортуються так само й порівнюються попарно, використовується найменша коробка, що підходить. Товари без розмірів поміщаються в коробку S. Посилка, яка не поміщається в жодну коробку, приховує спосіб. Розміри товару перераховуються з одиниці виміру магазину. Стандартні розміри: S 12 x 36 x 60, M 20 x 36 x 60, L 36 x 38 x 60, XL 36 x 60 x 60. Розміри, які не є додатними числами, повідомляються після збереження й не змінюються.

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

Доступність

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

Maximum weight (kg): приховує спосіб, коли кошик важчий. За замовчуванням: 25. 0 — без обмеження.

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

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

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

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

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

Pickup point types: які пункти SmartPost може вибрати покупець: Parcel lockers (APT), Parcel boxes (IPB), Parcel shops (PUDO) і Posti post offices (Finland). Залиште порожнім, щоб пропонувати поштомати, бокси та пункти видачі посилок (за замовчуванням). Які типи існують, залежить від країни: наприклад, у Латвії є лише посилкові бокси, а відділення пошти є тільки у Фінляндії.

City order: коли увімкнено, великі міста йдуть першими (Таллінн, Рига, Вільнюс, Гельсінкі та інші великі міста), далі решта за алфавітом. Коли вимкнено, усі міста за алфавітом.

Додатково

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

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

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

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

Список пунктів видачі кожної країни кешується на 24 години, і зберігається копія останнього робочого списку. Невдале завантаження запам'ятовується на 15 хвилин, щоб оформлення замовлення не чекало списку під час кожного оновлення. Тайм-аут завантаження — 15 секунд. Різні написання одного міста (наприклад, Riga і Rīga) показуються як одне місто.

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

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

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

Коли покупець обирає SmartPost, під способом доставки з'являються два списки: -- Select city -- і -- Select pickup point --. Списки завжди належать до країни доставки. У класичному оформленні це країна адреси доставки, а якщо замовлення не відправляється на іншу адресу — країна адреси для рахунку; списки перебудовуються, коли змінюється країна. У блочному оформленні списки слідують за країною адреси доставки. Місто з адреси доставки вибирається автоматично, якщо воно збігається з містом у списку. Кожен пункт показується з назвою та адресою. Вибір запам'ятовується під час оформлення, тож він не губиться під час оновлення сторінки.

Пункт видачі обов'язковий. У класичному оформленні покупець бачить Please select a SmartPost pickup point in the shipping country. У блочному оформленні кнопка Place order заблокована, доки не обрано пункт. В обох варіантах сервер повторно перевіряє пункт за списком країни доставки, тож підроблений або застарілий ID пункту чи пункт іншої країни відхиляється. Якщо список країни тимчасово недоступний, покупець бачить повідомлення й може обрати інший спосіб доставки.

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

Щоб змінити пункт замовлення, відкрийте замовлення та натисніть Change поруч із SmartPost pickup point. Оберіть місто й пункт у країні доставки замовлення. Новий пункт зберігається одразу, а примітка до замовлення фіксує старий і новий пункт.

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

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

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

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

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

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

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

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

Немає пунктів видачі для країни: список SmartPost не вдалося завантажити, і збереженої копії немає. Плагін повторює спробу кожні 15 хвилин. Пізніше натисніть Refresh pickup point lists now. Також перевірте, що в Pickup point types є тип, який існує в цій країні.

Список пунктів видачі застарів: натисніть Refresh pickup point lists now на сторінці налаштувань. Списки також завантажуються знову кожні 24 години.

Покупець не може оформити замовлення: потрібно обрати пункт видачі країни доставки. Якщо покупець бачить "The SmartPost pickup point list is temporarily unavailable", пунктів цієї країни наразі немає.

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

Для розробників: фільтр vfd_smpt_places_url змінює URL списку місць для країни (аргументи: URL, код країни), наприклад для дзеркала, яке повертає той самий XML.

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

Видалення

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

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