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

Вимоги

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

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

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

Облікові дані Budbee API (лише для вибору посилкової скриньки): API-ключ і API-секрет. Instabee видає їх мерчантам з договором на доставку. Зверніться до свого контакту в Instabee або скористайтеся порталом мерчанта Instabee. Документація API розміщена на developer.budbee.com. Без облікових даних спосіб доставки працює з фіксованими цінами, але покупці не можуть вибрати посилкову скриньку.

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

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

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

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

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

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

5. Заповніть розділ Ціни, а для вибору посилкової скриньки вкажіть ваші API key та API secret Budbee (див. розділ «Налаштування»).

6. Додайте VibeFox Instabee до зон доставки країн, куди ви доставляєте (наприклад, Швеція), у розділі WooCommerce > Settings > Shipping > Shipping zones або увімкніть Ignore shipping zones і виберіть країни.

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

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

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

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

Загальні

Enable/Disable: вмикає або вимикає спосіб скрізь, включно із зонами доставки. За замовчуванням: увімкнено.

Method name: назва способу доставки, яка показується в кошику та під час оформлення замовлення. Зона може замінити її власним Title. За замовчуванням: Instabee parcel box.

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

Вибір посилкової скриньки (Budbee API)

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

API key: ваш API-ключ Budbee (ім'я користувача HTTP Basic).

API secret: ваш API-секрет Budbee (пароль HTTP Basic).

Test environment: використовує тестовий API Budbee (api.staging.budbee.com). Вмикайте його лише з тестовими обліковими даними від Instabee. Робочі магазини залишають його вимкненим (api.budbee.com). За замовчуванням: вимкнено.

Ціни (у заголовку розділу показано валюту вашого магазину)

Усі ціни вказуються у валюті магазину. Приймаються і десятковий кома, і десяткова крапка (49,90 = 49.90). Значення, яке не є числом, не зберігається, і повідомлення про помилку називає поле.

Calculation type: спосіб застосування ціни.

Country prices: таблиця з колонками Country, Price, XS (до 1 кг), S (до 2 кг), M (до 3 кг), L (до 5 кг) і XL (понад 5 кг). Натисніть + Add country, щоб додати рядок, і хрестик, щоб видалити його. Оберіть * Any other country для рядка, який застосовується до всіх країн без власного рядка. Порожній діапазон або 0 використовує колонку Price. Price 0 означає безкоштовну доставку. Якщо в рядку країни немає ціни для ваги кошика, використовується рядок *, потім Fallback cost. Ваги переводяться з одиниці ваги вашого магазину в кг.

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

Умови

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

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

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

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

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

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

Зазвичай ви додаєте VibeFox Instabee до зони доставки. Як альтернативу його можна увімкнути тут для списку країн.

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

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

Додатково

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

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

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

Коли покупець вводить адресу доставки, WooCommerce запитує в плагіна тариф. Плагін перевіряє умови: вагу кошика, мінімальну суму замовлення та виключені класи доставки. Якщо проміжна сума кошика досягає Free shipping from, тариф безкоштовний. Інакше ціна береться з рядка Country prices країни призначення, рядка * або Fallback cost. Якщо ціни немає, спосіб приховується.

Коли покупець обирає тариф Instabee і облікові дані API задані, під тарифом для Швеції, Фінляндії, Данії, Нідерландів і Бельгії з'являється вибір Parcel box. Він показує скриньки поблизу поштового індексу адреси доставки, відсортовані за відстанню, з назвою, адресою та відстанню. Покупець може ввести інший поштовий індекс і натиснути Search. Доки поштовий індекс не введено, вибір його запитує. Якщо скриньок не знайдено, покупцеві пропонують спробувати інший поштовий індекс або обрати інший спосіб доставки.

Скриньку обов'язково вибрати. Під час оформлення замовлення плагін перевіряє на сервері, що обрана скринька є у списку Budbee для цього поштового індексу. Інакше покупець бачить Please choose an Instabee parcel box. Назва скриньки береться зі списку Budbee, а не з браузера.

Плагін надсилає до Budbee лише країну призначення та поштовий індекс, ніколи не імена, адреси, e-mail або дані замовлення. Списки скриньок кешуються на 12 годин для кожного поштового індексу, індекс без скриньок — на 1 годину, а невдалий запит — на 5 хвилин, щоб повільний або зламаний API не сповільнював кожне оновлення оформлення замовлення. Тайм-аут API — 10 секунд.

Якщо API Budbee недоступний, покупцеві повідомляється, що замовлення можна оформити без вибору скриньки. Тоді замовлення позначається, а скриньку ви обираєте під час оформлення відправлення. Раніше обрана скринька, яку в цей момент неможливо перевірити, зберігається і позначається як неперевірена.

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

Плагін не розраховує тарифи в реальному часі, не оформлює відправлення, не друкує етикетки, не надає номери та листи для відстеження, не пропонує слоти доставки Budbee Home і не показує карту. Оформіть посилку на обрану скриньку у ваших інструментах мерчанта Instabee / Budbee.

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

Обрана посилкова скринька зберігається в замовленні та показується в таких місцях:

Екран замовлення в адмін-панелі: під адресою доставки, як Instabee parcel box з назвою скриньки, адресою та Box ID. Якщо скриньку не вдалося перевірити під час оформлення, вона позначається як not verified (Budbee API was unavailable at checkout). Якщо скриньку не обрано, бо API був недоступний, екран про це повідомляє і нагадує обрати скриньку під час оформлення відправлення.

Сторінка «Дякуємо» та сторінка замовлення в «Мій обліковий запис»: назва й адреса скриньки.

Листи про замовлення: HTML і простий текст. Листи магазину також показують ID скриньки. Якщо скриньку не обрано, бо API був недоступний, про це пишуть лише листи магазину.

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

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

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

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

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

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

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

Покупці не бачать список посилкових скриньок: список з'являється лише тоді, коли задано API key і API secret, для Швеції, Фінляндії, Данії, Нідерландів і Бельгії, і після введення поштового індексу. Остання помилка API показується над налаштуваннями. Деталі — у WooCommerce > Status > Logs (джерело vfd-instabee). Увімкніть Debug log для докладнішої інформації.

HTTP 401 або 403 у журналі: Budbee відхилив API-ключ або секрет. Перевірте їх і переконайтеся, що Test environment відповідає вашим обліковим даним (тестові облікові дані лише з увімкненим тестовим середовищем).

Немає скриньок для поштового індексу: Budbee не обслуговує цей поштовий індекс. Покупець може ввести інший індекс або обрати інший спосіб доставки.

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

Інші країни для пошуку скриньок: розробники можуть змінити список країн за допомогою фільтра vfd_ibee_box_countries.

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

Видалення

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

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