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

Вимоги

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

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

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

Econt: договір і ключ API не потрібні. Список офісів — це публічна номенклатура Econt. В Econt передається лише код країни, без даних покупців. Логін і пароль e-Econt вкажіть, тільки якщо Econt вимагає від вашого сайту авторизацію. Вхід в e-Econt описано на сторінці для розробників Econt (econt.com/developers).

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

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

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

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

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

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

5. Встановіть тарифи за країнами та перевірте інші параметри (див. розділ «Налаштування»). Натисніть Load offices from Econt now, щоб перевірити з'єднання.

6. Додайте VibeFox Econt до зони доставки з Болгарією та/або Румунією в WooCommerce > Settings > Shipping > Shipping zones або увімкніть Ignore zones і виберіть країни.

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

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

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

У верхній частині сторінки плагін показує попередження: увімкнено демо-API, не встановлено тариф для Болгарії або Румунії (тоді спосіб ніколи не показується), або останній запит офісів для країни завершився помилкою. Числові поля приймають десятковий кому, наприклад 5,99. Значення, яке не є числом, ігнорується і повідомляється під час збереження.

Загальні

Enable/Disable: вмикає або вимикає доставку Econt у всіх зонах одночасно. За замовчуванням: увімкнено.

Name: назва способу доставки, яку бачить покупець на оформленні. Title, заданий у зоні, її замінює. За замовчуванням: Econt Express.

Tax status: Taxable додає податок WooCommerce до вартості доставки, None не додає. За замовчуванням: Taxable.

Список офісів Econt

Офіси та Econtomat завантажуються з API Econt і кешуються на 24 години.

Demo API: використовувати демо-API Econt з тестовими даними. На робочому магазині тримайте вимкненим. Демо-офіси мають інші ID, ніж справжні. У демо-режимі, якщо логін не встановлено, використовується публічний тестовий обліковий запис Econt.

Econt username: необов'язково. Ваш логін e-Econt для HTTP Basic-авторизації.

Econt password: необов'язково. Зберігається в базі даних WordPress і ніколи не записується в журнал.

Office list: показує, скільки офісів закешовано за кожною країною і коли їх завантажено. Кнопка Load offices from Econt now перезавантажує списки негайно та показує результат. Якщо завантаження не вдалося, зберігаються офіси з останнього успішного завантаження. Без цієї кнопки список завантажується автоматично на першому оформленні замовлення. Після зміни Demo API, логіна або пароля закешовані списки очищаються.

Вибір офісу на оформленні замовлення

Show: які пункти може обирати покупець.

City order: спочатку показувати найбільші міста (Софія, Пловдив, Варна, Бухарест та інші). Якщо вимкнено, міста сортуються за алфавітом. За замовчуванням: увімкнено.

City list width: ширина списку міст у CSS на класичному оформленні замовлення, наприклад 100% або 300px. За замовчуванням: 100%.

Office list width: ширина списку офісів у CSS на класичному оформленні замовлення, наприклад 100% або 400px. За замовчуванням: 100%.

Тарифи (у валюті вашого магазину)

Плагін не запитує в Econt актуальні тарифи. З 1 січня 2026 року в Болгарії використовується євро, тому болгарський магазин зазвичай вводить тарифи в EUR.

Price per country: одна країна в рядку (або через кому): код країни, двокрапка, тариф, наприклад BG:5.99 і RO:8.99 (це значення за замовчуванням). Допускається десятковий кома: BG:5,99. Тариф 0 означає безкоштовну доставку. Записи в іншому форматі ігноруються і перелічуються в повідомленні про помилку під час збереження.

Calculation: Per order стягує тариф один раз. Per item (price x quantity) множить його на кількість товарів до доставки в кошику.

Price for other countries: використовується для країни Econt (Болгарія або Румунія), якої немає в списку вище. Порожнє значення або 0 приховує спосіб у цій країні.

Умови

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

Minimum subtotal: показувати спосіб, лише якщо сума кошика не менша за це значення. Залиште порожнім, щоб показувати завжди.

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

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

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

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

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

Countries: Болгарія та/або Румунія. Використовується лише з Ignore zones. Залиште порожнім для всіх країн Econt, куди відправляє ваш магазин.

Додатково

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

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

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

Спосіб пропонується лише для Болгарії та Румунії. Коли покупець вводить адресу доставки, плагін перевіряє вагу кошика, мінімальну суму та приховані класи доставки, а потім бере тариф для країни. Якщо сума кошика досягає Free shipping from, тариф дорівнює 0. Якщо для країни немає доступного списку офісів, спосіб приховується, бо доставка завжди здійснюється в офіс.

Коли покупець обирає Econt, під способом з'являються два списки: City та Office / Econtomat. Список офісів завантажується один раз на сторінку. Econtomat позначено в списку. Вибір запам'ятовується протягом сесії. Якщо список офісів не вдалося завантажити, покупець бачить повідомлення спробувати знову за кілька хвилин або обрати інший спосіб доставки.

Покупець не може оформити замовлення без вибору офісу. На сервері плагін повторно перевіряє, що офіс є в списку Econt для країни доставки. Назву офісу завжди беруть зі списку Econt, а не з браузера. Це працює в класичному та блочному оформленні замовлення. Плагін сумісний із високопродуктивним зберіганням замовлень WooCommerce (HPOS).

Список офісів кешується на 24 години. Якщо Econt недоступний, використовується останній успішний список, і Econt не запитується повторно протягом 10 хвилин. Тайм-аут API — 15 секунд.

Плагін використовує лише фіксовані тарифи. Він не запитує в Econt актуальні тарифи, не створює накладних і етикеток, не викликає кур'єрів, не відстежує посилки, не приймає накладений платіж і не доставляє на адресу. Список офісів є лише в Болгарії та Румунії.

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

Обраний офіс зберігається разом із замовленням: місто, назва й адреса офісу та код офісу Econt. Використовуйте код офісу, коли створюєте відправлення в e-Econt.

Екран замовлення в адмін-панелі: офіс і код офісу показані під адресою доставки. Натисніть Change, щоб завантажити список офісів і вибрати інше місто та офіс. Зміна зберігається одразу, а примітка до замовлення фіксує старий і новий офіс.

Покупець: офіс відображається на сторінці замовлення покупця та сторінці «Дякуємо за замовлення», а також у листах про замовлення (HTML і текстова версія).

Назви офісів виводяться місцевою мовою (кирилиця для Болгарії), якщо мова сайту — болгарська або румунська, в інших випадках англійською.

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

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

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

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

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

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

Econt не з'являється на оформленні замовлення: перевірте, що ліцензія активна, увімкнено Enable/Disable, країна доставки — Болгарія або Румунія, а спосіб додано до зони цієї країни (або увімкнено Ignore zones і країна дозволена). Перевірте, що для країни встановлено тариф, обмеження за вагою, Minimum subtotal і Hide for shipping classes. Перегляньте рядок Office list у налаштуваннях: спосіб приховано, доки для країни немає списку офісів.

Список офісів не завантажується: натисніть Load offices from Econt now і прочитайте результат або попередження у верхній частині сторінки налаштувань. Помилки записуються в WooCommerce > Status > Logs, джерело vfd-econt. Якщо Econt вимагає авторизацію для вашого сайту, заповніть Econt username і Econt password.

Покупці бачать тестові офіси: увімкнено Demo API. Вимкніть його на робочому магазині.

У якій валюті тарифи? У валюті вашого магазину.

Інші країни: розробники можуть додати країни за допомогою фільтра vfd_ecn_countries (двобуквений код, зіставлений із трибуквеним кодом).

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

Видалення

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

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