VibeFox LP Express for WooCommerce — Помощь

Требования

WordPress: 5.8 или новее.

WooCommerce: 7.0 или новее, установлен и активен. Плагин не активируется без него.

PHP: 8.0 или новее.

LP Express: аккаунт API не нужен. У LP Express нет публичного API тарифов. API Unisend доступно только клиентам с договором, и этот плагин его не использует, поэтому вы вводите собственные (договорные) тарифы. Создавайте посылки в своём аккаунте Unisend («Mano siuntos»).

Список терминалов посылок: плагин использует открытый список терминалов LP Express, тот же, что использовали старые плагины LP Express. На момент выпуска версии 1.1.0 этот онлайн-список был недоступен. Пока он недоступен, плагин использует последнюю загруженную копию, если она есть, иначе ваш собственный список. Будьте готовы ввести собственный список (см. Настройка).

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

Установка

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

2. Нажмите Activate.

3. Откройте настройки: WooCommerce > Settings > Shipping > VibeFox LP Express или нажмите Settings под названием плагина на странице Plugins.

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

5. Заполните таблицу тарифов (хотя бы одну строку) или запасную стоимость. Проверьте строку статуса о терминалах посылок вверху страницы и добавьте собственный список терминалов, если онлайн-список недоступен.

6. Добавьте VibeFox LP Express в зону доставки для Литвы в WooCommerce > Settings > Shipping > Shipping zones или включите Ignore shipping zones и выберите страны.

Настройка

Все настройки находятся на одной странице: WooCommerce > Settings > Shipping > VibeFox LP Express. Они действуют для всех зон доставки. Когда вы добавляете способ в зону, в окне зоны есть только одно поле:

Title (zone): название, которое покупатели видят для этой зоны. Оставьте поле пустым, чтобы использовать общий Method title.

Вверху страницы уведомления показывают проблемы и статус терминалов. Красное уведомление появляется, когда цена не задана или нет доступных терминалов посылок, поскольку тогда способ не показывается на оформлении заказа. Информационная строка показывает, сколько терминалов посылок в скольких городах доступно и из какого источника: онлайн-список, сохранённая копия онлайн-списка (с датой) или ваш собственный список.

Общие

Enable/Disable: включает или выключает LP Express во всех зонах сразу.

Method title: название способа доставки, которое видят покупатели. Название способа в зоне его переопределяет. По умолчанию: LP Express parcel terminal.

Tax status: Taxable добавляет налог WooCommerce к стоимости доставки, None — не добавляет.

Тарифы (в валюте вашего магазина; десятичные значения можно вводить как 2.99 или 2,99)

Price table: одна строка на страну назначения. Нажмите + Add country, чтобы добавить строку, и крестик (×), чтобы удалить её. Выберите * Any other country для всех стран, у которых нет собственной строки. В каждой строке есть Base price и весовые колонки: XS (≤1 kg), S (≤2 kg), M (≤3 kg), L (≤5 kg) и XL (>5 kg). Вес — это вес корзины или вес одного товара при Per item. Пустая колонка использует базовую цену строки. 0 означает бесплатно. Цены, которые не являются числами, сообщаются после сохранения и остаются пустыми.

Fallback cost: используется, когда в таблице тарифов нет строки для страны назначения. Оставьте поле пустым, чтобы скрыть способ для таких стран.

Calculation: как считается цена.

Per order (tier by total cart weight): одна цена на корзину, колонка веса выбирается по общему весу корзины. Это значение по умолчанию.

Per item (each item priced by its own weight x quantity): каждый товар оценивается по своему весу, умноженному на количество, и цены суммируются.

Free shipping from: сумма корзины (после скидок, как она показана в корзине), начиная с которой LP Express бесплатен. Оставьте пустым, если бесплатной доставки нет.

Доступность

Minimum weight (kg): скрывает способ, когда корзина легче этого значения. Пусто или 0 — без ограничения.

Maximum weight (kg): скрывает способ, когда корзина тяжелее. Терминалы LP Express принимают посылки до 30 кг. По умолчанию: 30. 0 — без ограничения.

Minimum cart total: показывает способ только от этой суммы корзины. Оставьте пустым, чтобы показывать всегда.

Excluded shipping classes: скрывает способ, когда в корзине есть товары этих классов доставки WooCommerce.

Ignore shipping zones: предлагает LP Express для стран, указанных ниже, без добавления его в зону. Когда опция выключена, страны определяются зонами доставки, в которые добавлен способ. Это рекомендуемый вариант.

Countries (without zones): страны назначения для этого режима. Поле используется, только если включено Ignore shipping zones. Оставьте пустым, чтобы предлагать способ для любого адреса.

Терминалы посылок

Terminal list: откуда берутся терминалы.

LP Express online list: онлайн-список загружается раз в сутки. Если его не удаётся загрузить, используется последняя загруженная копия, затем ваш собственный список ниже. Это значение по умолчанию.

Only my own list: предлагаются только терминалы, которые вы введёте ниже.

Сохранение настроек перезагружает список терминалов.

Дополнительно

Debug log: записывает расчёт цен и подробности списка терминалов в WooCommerce > Status > Logs (источник vfd-lp-express). Ошибки, например недоступный список терминалов, записываются всегда. Данные покупателей не записываются.

Remove data on uninstall: если включено, удаление плагина удаляет настройки, методы зон и кэшированные терминалы. Деактивация плагина никогда не удаляет настройки. Терминал, сохранённый в заказах, сохраняется.

Как это работает при оформлении заказа

Когда покупатель вводит адрес доставки, WooCommerce запрашивает у плагина тариф. Плагин проверяет вес корзины, минимальную сумму корзины и исключённые классы доставки. Если терминалов посылок нет, способ скрывается, поэтому покупатель никогда не видит оформление заказа, которое невозможно завершить. Если применяется бесплатная доставка, цена равна 0. Иначе цена берётся из строки страны (или строки *): колонка веса, затем базовая цена, затем запасная стоимость. Если цены нет, способ скрывается.

Онлайн-список терминалов кэшируется на 24 часа. Неудачная загрузка запоминается на 15 минут, чтобы оформление заказа не ждало список при каждом обновлении. Тайм-аут загрузки — 10 секунд. Предлагаются только активные терминалы из списка.

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

Плагин не запрашивает тарифы LP Express или Unisend, не создаёт отправления, не печатает этикетки, не вызывает курьера и не отслеживает посылки. Создавайте посылки в своём аккаунте Unisend («Mano siuntos»). Курьерская доставка до двери не входит в этот способ.

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

Когда покупатель выбирает LP Express, под способом доставки появляются два списка: -- Select city -- и -- Select parcel terminal --. Город из адреса доставки выбирается автоматически, если он совпадает с городом в списке. Каждый терминал показывается с названием, адресом и почтовым индексом. Выбор запоминается во время оформления заказа, поэтому он не теряется при обновлении страницы.

Терминал обязателен. На классическом оформлении заказа покупатель видит Please select an LP Express parcel terminal. В блочном оформлении заказа кнопка Place order заблокирована, пока не выбран терминал. В обоих вариантах оформления сервер повторно проверяет терминал по списку, поэтому поддельный или устаревший ID терминала отклоняется.

ID, название и город терминала сохраняются в заказе. Они показываются на экране заказа под адресом доставки (вместе с ID терминала), на странице «Заказ получен», в разделе My account > Orders и в письмах о заказе (HTML и простой текст) как LP Express parcel terminal.

Лицензионный ключ

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

Один ключ работает на одном домене. Удаление ключа с сайта не освобождает место для домена. Освободите его в своём аккаунте на vibefox.net.

Без активного ключа LP Express не показывается покупателям на оформлении заказа. Авторизованные менеджеры магазина по-прежнему видят его, отмеченным как (unlicensed — visible to admins only), поэтому вы можете настроить и протестировать плагин до покупки ключа. Напоминание появляется на странице Plugins и на страницах WooCommerce. Существующие заказы не затрагиваются.

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

Устранение неполадок

LP Express не появляется на оформлении заказа: проверьте, что лицензия активна, что Enable/Disable включено и способ добавлен в зону страны покупателя (или что включено Ignore shipping zones и страна разрешена). Откройте страницу настроек: красное уведомление объяснит, если цена не задана или нет доступных терминалов посылок. Проверьте также ограничения по весу, Minimum cart total и Excluded shipping classes. Если включён Debug log, раздел WooCommerce > Status > Logs (источник vfd-lp-express) покажет, почему способ скрыт.

Нет терминалов посылок: онлайн-список не удалось загрузить, и нет ни сохранённой копии, ни собственного списка. Плагин повторяет попытку каждые 15 минут. Введите собственный список в Own terminal list или выберите Only my own list.

Список терминалов устарел: сохраните страницу настроек. Это перезагрузит список терминалов. Если используется собственный список, обновите строки самостоятельно.

Покупатель не может оформить заказ: нужно выбрать терминал посылок. Если покупатель видит «The LP Express parcel terminal list is temporarily unavailable», терминалов сейчас нет. Добавьте собственный список.

В какой валюте цены: в валюте вашего магазина. Плагин не конвертирует валюты.

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

Удаление

Деактивация плагина сохраняет все настройки. Очищается только кэш списка терминалов. Чтобы удалить плагин, деактивируйте его и удалите на странице Plugins. Лицензионный ключ и статус лицензии этого плагина, а также кэши удаляются всегда. Настройки, методы зон и сохранённая копия списка терминалов удаляются, только если была включена опция Remove data on uninstall. Иначе они сохраняются для повторной установки. Терминал, сохранённый в заказах, никогда не удаляется, а существующие заказы сохраняют свои строки доставки.

LP Express — товарный знак его владельца. Этот плагин не связан с LP Express и не одобрен LP Express.