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.