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: як обчислюється ціна.

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: звідки беруться термінали.

Own terminal list: один термінал у рядку у форматі ID | Name | City | Address | ZIP, наприклад 1234 | LP EXPRESS Akropolis | Vilnius | Ozo g. 25 | LT-07150. ID і City обов'язкові. Рядки, що починаються з #, ігноруються. Використовуйте ID терміналів, які очікує ваш обліковий запис Unisend.

Додатково

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 і не схвалений нею.