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: сначала показывает самые крупные города (Таллин, Рига, Вильнюс и другие), затем остальные по алфавиту. По умолчанию включено. Когда выключено, города сортируются по алфавиту.

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 --. Показываются только города и постаматы страны доставки; когда покупатель меняет страну, списки тоже меняются. В Эстонии города — это уезды, при этом Таллин, Тарту и Пярну перечислены отдельно; в Латвии и Литве — города и муниципалитеты. Город из адреса доставки выбирается заранее, если совпадает с городом из списка. Каждый постамат показывается с названием и адресом. Выбор запоминается на время оформления, поэтому не теряется при обновлении страницы оформления.

Постамат обязателен. На классическом оформлении покупатель видит 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 и не одобрен ею.