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

Требования

PrestaShop: 8.0–9.x.

PHP: 8.0 или новее. Модуль отказывается устанавливаться на более старых версиях PHP.

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

Список терминалов посылок: модуль использует открытый список терминалов LP Express (https://www.lpexpress.lt/index.php?cl=terminals&fnc=getTerminals). Ключ не нужен. Если этот онлайн-список недоступен, модуль использует последнюю загруженную копию, если она есть, а иначе ваш собственный список. Будьте готовы ввести собственный список (см. раздел «Настройка»).

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

Установка

1. В бэк-офисе перейдите в Modules > Module Manager и нажмите Upload a module. Выберите ZIP-файл модуля.

2. По завершении загрузки нажмите Configure или найдите VibeFox LP Express позже в списке модулей и нажмите Configure.

3. Введите лицензионный ключ VibeFox в поле License key в блоке лицензии вверху страницы Configure и нажмите Activate (см. раздел «Лицензионный ключ»).

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

При установке модуль создаёт перевозчика LP Express parcel terminal с текстом срока доставки Delivery to an LP Express parcel terminal. Перевозчик назначается зоне Литвы и всем группам покупателей. Добавлять зоны и менять группы покупателей, срок доставки, логотип и ограничения по размеру можно в Shipping > Carriers. Цены там не задавайте: цена всегда берётся из модуля.

Настройка

Все настройки находятся на странице модуля: Modules > Module Manager > VibeFox LP Express > Configure. Каждый раздел имеет свою кнопку Save, которая сохраняет всю страницу. Каждое сохранение также перезагружает список терминалов.

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

При сохранении название способа доставки, которое пустое или не подходит как название перевозчика, отклоняется с сообщением Enter a valid method title., и название длиннее 64 символов тоже отклоняется. В обоих случаях ничего не сохраняется. Сумма или вес, которые не являются числом (или отрицательны), отмечаются, и сохраняется прежнее значение. Minimum weight (kg) больше, чем Maximum weight (kg) (30 кг, если максимум пуст), тоже отмечается, потому что перевозчик никогда не будет показан, и оба веса сохраняют прежние значения. Цены в таблице, которые не являются числами, отмечаются и остаются пустыми.

Общие

Enable/Disable: включает или выключает LP Express. Это тот же переключатель, что и статус перевозчика в Shipping > Carriers.

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

Tax status: None означает, что цены ниже окончательные. Taxable с налоговым правилом (по одному варианту на каждое налоговое правило вашего магазина) означает, что PrestaShop добавляет этот налог на доставку к ценам ниже. Это налоговое правило перевозчика.

Цены (в валюте магазина по умолчанию; десятичные значения можно писать как 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 означает без ограничения. Пусто означает 30 кг в зонах перевозчика, а без ограничения — только для стран из Ignore shipping zones, которые находятся вне этих зон.

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

Ignore shipping zones: предлагать LP Express для стран, указанных ниже, без настройки зон вручную. Тогда перевозчик привязывается ко всем активным зонам (в том числе к зонам, созданным позже). Зоны, которые перевозчик имел раньше, остаются разрешёнными для всех своих стран. Когда вы снова выключаете опцию, перевозчик возвращает зоны, которые у него были раньше. Когда опция выключена, страны определяются зонами перевозчика в Shipping > Carriers. Рекомендуется именно так.

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

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

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

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

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

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

Debug log: записывает детали расчёта цен и списка терминалов в файл logs/vfd_lpex_debug.log.php в папке модуля. Открыть файл через веб нельзя. Ошибки, например недоступный список терминалов, всегда записываются. Данные покупателей не записываются.

Log: показывает размер и последние записи журнала. Нажмите Clear log, чтобы очистить его.

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

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

На этапе доставки PrestaShop запрашивает у модуля цену LP Express. Учитываются только физические товары: виртуальные товары не добавляют вес и не входят в сумму корзины. Модуль проверяет страны из Ignore shipping zones, вес корзины и минимальную сумму корзины. Если применяется бесплатная доставка, цена равна 0. Иначе цена берётся из строки страны (или строки *): весовой колонки, затем базовой цены, затем запасной стоимости. Если цены нет или ни один терминал посылок не доступен, перевозчик скрывается, поэтому покупатель никогда не видит оформление заказа, которое нельзя завершить.

Цены и суммы указываются в валюте магазина по умолчанию. Затем цена показывается в валюте корзины покупателя по курсу PrestaShop.

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

Если вы редактируете перевозчика в Shipping > Carriers после того, как у него появились заказы, PrestaShop сохраняет его как новую версию перевозчика. Модуль автоматически переходит на новую версию.

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

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

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

Терминал обязателен. Без него кнопки Continue на этапе доставки и Place order показывают сообщение Please select an LP Express parcel terminal. Когда покупатель нажимает Continue, сервер проверяет терминал по списку ещё раз, поэтому поддельный или устаревший ID терминала отклоняется с сообщением The selected LP Express parcel terminal is not available any more. Please select a parcel terminal again.

ID, название и город терминала сохраняются вместе с заказом. Они показываются в блоке LP Express parcel terminal на странице заказа в бэк-офисе (с полем Terminal ID), на странице подтверждения заказа и в деталях заказа покупателя. В письме с подтверждением заказа и в письме о новом заказе продавцу они добавляются к названию перевозчика в виде LP Express parcel terminal: и далее сам терминал. Если в заказе нет терминала, страница заказа в бэк-офисе показывает No parcel terminal was chosen for this order.

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

Модуль работает с лицензионным ключом VibeFox, полученным на vibefox.net. Блок лицензии License — VibeFox LP Express — первый блок на странице Modules > Module Manager > VibeFox LP Express > Configure, над настройками. Вставьте ключ в License key и нажмите Activate. После этого блок показывает ключ в замаскированном виде, статус (например, дату, до которой лицензия действует, и ваш домен) и кнопки Check now для повторной проверки статуса, Change key для ввода другого ключа и Remove key для удаления ключа из этого магазина. Ниже находятся строка Product: presta-shipping-lp-express и ссылка Manage licenses and domains in your account, которая открывает ваш аккаунт vibefox.net. Изменить ключ могут только сотрудники с правом Configure для модуля. Тексты блока следуют языку бэк-офиса (включены английский и русский).

Если ключ не принят, блок сообщает причину, например Key not found, This key belongs to another product, Domain limit reached или License expired on и дату. После смены адреса магазина или после освобождения слота домена в аккаунте нажмите Check now. Если сервер лицензий недоступен, модуль продолжает работать по последнему известному статусу.

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

Без действующего ключа перевозчик LP Express не показывается покупателям при оформлении заказа, и стоимость доставки не рассчитывается. Витрина PrestaShop не знает, что вы вошли в бэк-офис, поэтому перевозчик скрыт и для вас: модуль можно настроить до покупки ключа, но нельзя проверить при оформлении заказа. Напоминание появляется в Modules > Module Manager на вкладке Alerts. Существующие заказы не затрагиваются.

Когда лицензия истекает, модуль продолжает работать, но для обновлений и поддержки нужно продление. Статус автоматически перепроверяется во время работы в бэк-офисе: раз в день в первые 14 дней после ввода ключа, затем раз в неделю. Задание cron не требуется. Удаление или сброс модуля всегда удаляет лицензионный ключ и статус лицензии.

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

LP Express не появляется при оформлении заказа: проверьте, что лицензия активна и включена опция Enable/Disable. В Shipping > Carriers проверьте, что перевозчик охватывает зону страны покупателя и группу покупателя (или что включена опция Ignore shipping zones и страна разрешена). Откройте страницу модуля: предупреждение объяснит, если не задана цена или не доступен ни один терминал посылок. Также проверьте ограничения по весу и Minimum cart total. Товары также могут быть ограничены определёнными перевозчиками на странице товара. Если включён Debug log, поле Log на странице модуля покажет, почему перевозчик был скрыт.

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

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

Покупатель не может продолжить: нужно выбрать терминал посылок. Если покупатель видит сообщение The LP Express parcel terminal list is temporarily unavailable. Please try again later or choose another shipping method., терминалы сейчас недоступны. Добавьте собственный список.

В какой валюте цены: в валюте магазина по умолчанию. Покупатели, которые платят в другой валюте, видят цену, пересчитанную по курсу PrestaShop.

Страница сообщает, что перевозчик LP Express не найден: перевозчик был удалён в Shipping > Carriers. Сбросьте модуль в Modules > Module Manager, чтобы создать его заново.

Удаление

Перейдите в Modules > Module Manager, откройте меню рядом с VibeFox LP Express и выберите Uninstall. Лицензионный ключ и статус лицензии всегда удаляются. Кэшированный список терминалов всегда очищается. Если опция Remove data on uninstall включена, перевозчик удаляется (заказы сохраняют историю), а настройки, журнал и сохранённая копия списка терминалов удаляются. Если она выключена, перевозчик только отключается, а все настройки и сохранённая копия остаются. При повторной установке модуля сохранённый перевозчик получает статус, который был у него раньше. Терминал, сохранённый в заказах, никогда не удаляется.

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