VibeFox LP Express for OpenCart — Допомога

Вимоги

OpenCart: 3.0.x (перевірено на 3.0.5.0) або 4.0.2 і новіша (перевірено на 4.1.0.3), зі стандартною темою та стандартним оформленням замовлення OpenCart.

PHP: 8.0 або новіша версія.

LP Express: обліковий запис API не потрібен. LP Express не має публічного API тарифів, а розширення не використовує API Unisend, тому ви вводите власні (договірні) тарифи. Створюйте відправлення у своєму обліковому записі Unisend («Mano siuntos»).

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

Литва: країна має бути увімкнена в System > Localisation > Countries.

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

Встановлення

Завантаження — це один zip-файл із пакетами для обох версій OpenCart. Розпакуйте його на своєму комп'ютері. Він містить README.txt, пакет для OpenCart 3 vfd_lp_express-oc3-(version).ocmod.zip і пакет для OpenCart 4 vfd_lp_express.ocmod.zip. Встановлюйте лише пакет для вашої версії OpenCart. Ліцензійний ключ однаковий для обох версій.

OpenCart 3

1. В адмін-панелі перейдіть до Extensions > Installer, натисніть Upload і виберіть файл vfd_lp_express-oc3-(version).ocmod.zip. Розширення не додає модифікацій OCMOD, тому оновлювати Extensions > Modifications не потрібно. Замість інсталятора можна скопіювати вміст папки upload з пакета в кореневу папку вашого магазину.

2. Перейдіть до Extensions > Extensions і виберіть тип розширень Shipping. Знайдіть VibeFox LP Express і натисніть Install (зелена кнопка +).

3. Натисніть Edit (кнопка з олівцем), щоб відкрити сторінку налаштувань.

4. Введіть ліцензійний ключ VibeFox у поле License key в блоці ліцензії вгорі сторінки Edit і натисніть Activate (див. Ліцензійний ключ).

5. Заповніть таблицю тарифів (принаймні один рядок; перший новий рядок — Литва) або вкажіть резервну вартість. Перевірте рядок статусу щодо поштових терміналів у верхній частині сторінки та додайте власний список терміналів, якщо онлайн-список недоступний. Увімкніть Enable/Disable і натисніть Save.

OpenCart 4

1. В адмін-панелі перейдіть до Extensions > Installer, натисніть Upload і виберіть файл vfd_lp_express.ocmod.zip. Не перейменовуйте файл: OpenCart 4 бере код розширення з імені файлу, і перейменований пакет не працює.

2. Пакет з'явиться у списку встановлених розширень на тій самій сторінці. Натисніть біля нього Install (зелена кнопка +).

3. Перейдіть до Extensions > Extensions і виберіть тип розширень Shipping. Знайдіть VibeFox LP Express, натисніть Install (зелена кнопка +), а потім Edit (кнопка з олівцем).

4. Введіть ліцензійний ключ і налаштування так само, як у кроках 4 і 5 для OpenCart 3. Сторінка налаштувань і її поля однакові в обох версіях.

Під час встановлення розширення створює дві невеликі таблиці (обрані термінали та кешований список терміналів) і реєструє свої події OpenCart для оформлення замовлення та сторінки замовлення. Спосіб доставки вимкнений, доки ви не увімкнете Enable/Disable і не збережете налаштування. Якщо ви встановлюєте розширення повторно після видалення, використовуються збережені налаштування.

Налаштування

Усі налаштування розташовані на сторінці розширення: Extensions > Extensions > Shipping > VibeFox LP Express > Edit. Розділи перелічено ліворуч. Одна кнопка Save внизу зберігає всю сторінку без перезавантаження. Кожне збереження також перезавантажує список терміналів. Зберігати налаштування можуть лише адміністратори з правом змінювати це розширення.

У верхній частині сторінки повідомлення показують проблеми та статус терміналів. Попередження з'являється, коли не встановлено жодної ціни або немає доступних поштових терміналів, оскільки тоді спосіб доставки не показується під час оформлення замовлення, а також коли в магазині немає класу ваги з одиницею kg: тоді ваги товарів визначаються за назвою їхньої одиниці (kg, g, lb, oz), а будь-яка інша одиниця вважається кілограмами. Інформаційний рядок показує, скільки поштових терміналів у скількох містах доступно та з якого джерела: онлайн-списку, збереженої копії онлайн-списку (з датою) або вашого власного списку.

Під час збереження назва способу доставки, яка порожня або містить один із символів < > ; = # { }, відхиляється з повідомленням Enter a valid method title., а назва довша за 64 символи також відхиляється. Порядок сортування, який не є цілим числом, теж відхиляється. У цих випадках нічого не зберігається. Сума або вага, що не є числом (або від'ємна), позначаються, і зберігається попереднє значення. Minimum weight (kg), більша за Maximum weight (kg) (30 кг, якщо максимум порожній), також позначається, оскільки спосіб доставки ніколи не показувався б; обидві ваги зберігають попередні значення. Ціни в таблиці, що не є числами, позначаються і залишаються порожніми. Інші значення зберігаються.

Загальні

Enable/Disable: показує або приховує LP Express під час оформлення замовлення (статус цього розширення). За замовчуванням: off.

Method title: назва способу доставки, яку покупці бачать у кошику та під час оформлення замовлення. За замовчуванням: LP Express parcel terminal. Обов'язкове поле, не більше 64 символів.

Tax class: --- None --- (за замовчуванням) означає, що наведені нижче ціни остаточні. З класом податку OpenCart додає податок на доставку до наведених нижче цін.

Sort order: місце LP Express серед способів доставки під час оформлення замовлення. Ціле число.

Ціни (у валюті за замовчуванням вашого магазину, яка вказана в заголовку розділу; десяткові числа можна записувати як 2.99 або 2,99)

Price table: один рядок на країну призначення. Натисніть Add country, щоб додати рядок, і кнопку видалення, щоб прибрати рядок. Виберіть * Any other country для кожної країни без власного рядка. У кожному рядку є Base price та колонки ваги: XS до 1 кг, S до 2 кг, M до 3 кг, L до 5 кг і XL понад 5 кг. Вага — це вага кошика або, з 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: показує спосіб доставки лише від цієї суми кошика (товари, що потребують доставки, після знижок, без податку). Залиште порожнім, щоб показувати його завжди.

Geo zone: спосіб доставки пропонується лише для адрес у цій геозоні. All Zones (за замовчуванням) означає всюди. Геозони керуються в System > Localisation > Geo Zones. Геозона не перевіряється, коли увімкнено Ignore shipping zones.

Ignore shipping zones: пропонує LP Express для країн, перелічених нижче, незалежно від геозони. У цьому режимі геозона не перевіряється. Коли вимкнено, країни визначаються геозоною. Це рекомендовано. За замовчуванням: off.

Countries (without zones): країни призначення для цього режиму. Це поле використовується лише коли увімкнено Ignore shipping zones. Залиште його порожнім, щоб пропонувати спосіб доставки для всіх країн.

Поштові термінали

Terminal list: звідки беруться термінали.

LP Express online list: онлайн-список завантажується раз на добу. Якщо його не вдається завантажити, використовується остання завантажена копія, а потім ваш власний список нижче. Це значення за замовчуванням.

Only my own list: пропонуються лише ті термінали, які ви введете нижче.

Додатково

Debug log: записує деталі розрахунку цін і списку терміналів у storage/logs/vfd_lpex_debug.log.php (в OpenCart 4 — system/storage/logs/vfd_lpex_debug.log.php). Файл не можна прочитати з веб-браузера. Помилки, як-от недоступний список терміналів або замовлення без терміналу, записуються завжди. Дані покупців не записуються. Коли файл досягає 5 МБ, починається новий журнал.

Log: показує розмір і останні записи журналу. Натисніть Clear log, щоб очистити його.

Remove data on uninstall: коли увімкнено, видалення розширення також видаляє налаштування, збережений список терміналів, журнал і термінали незавершених оформлень замовлення. Коли вимкнено (за замовчуванням), налаштування зберігаються для повторного встановлення. Термінал, збережений у замовленнях, завжди зберігається.

Імпорт / Експорт

Export: натисніть Download JSON, щоб зберегти налаштування у файл JSON.

Import: вставте раніше експортований JSON і натисніть Import, щоб відновити налаштування, наприклад в іншому магазині. Значення перевіряються так само, як під час звичайного збереження.

Як це працює під час оформлення замовлення

Коли OpenCart показує способи доставки, він запитує у розширення ціну LP Express. Якщо встановлено Geo zone і адреса знаходиться за її межами, LP Express не пропонується. З Ignore shipping zones геозона не перевіряється: LP Express пропонується лише для перелічених країн (для всіх країн, якщо список порожній). Враховуються лише товари, у яких Requires Shipping встановлено в Yes: інші товари не додають ваги й не входять до суми кошика. Сума кошика — це ціна таких товарів після знижки за купоном і до податку. Подарункові сертифікати, бонусні бали та кредит магазину не враховуються.

Розширення перевіряє вагу кошика та мінімальну суму кошика. Якщо діє безкоштовна доставка, ціна дорівнює 0. Інакше ціна береться з рядка країни (або рядка *): колонка ваги, інакше базова ціна, інакше резервна вартість. Якщо ціни немає або немає доступного поштового терміналу, спосіб доставки приховується, щоб покупець ніколи не побачив оформлення, яке неможливо завершити.

Ціни та суми вказані у валюті за замовчуванням вашого магазину. Ціна округлюється до своїх десяткових знаків і показується покупцеві в його валюті з податком вибраного Tax class.

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

На OpenCart 4 покупець натискає Choose у блоці способу доставки на сторінці оформлення замовлення і вибирає LP Express у вікні Shipping method options. Ціни такі самі, як в OpenCart 3.

Розширення не запитує тарифи LP Express чи Unisend, не створює відправлень, не друкує етикетки, не викликає кур'єра та не відстежує посилки. Створюйте відправлення у своєму обліковому записі Unisend («Mano siuntos»). Доставка кур'єром «від дверей до дверей» не входить до цього способу.

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

Коли покупець вибирає LP Express на кроці способу доставки, під ним з'являється блок LP Express parcel terminal з двома списками: -- Select city -- і -- Select parcel terminal --. Список терміналів завантажується лише тоді, коли вибрано LP Express. Місто з адреси доставки вибирається автоматично, якщо воно відповідає місту зі списку. Кожен термінал показується з назвою, адресою та поштовим індексом. Вибір одразу зберігається для оформлення замовлення, тож він не втрачається під час оновлення сторінки оформлення.

Термінал обов'язковий. Коли покупець натискає Continue, сервер перевіряє термінал за списком ще раз. Без терміналу оформлення показує Please select an LP Express parcel terminal. Підроблений або застарілий ID терміналу відхиляється повідомленням The selected LP Express parcel terminal is not available any more. Please select a parcel terminal again. Якщо термінали неможливо завантажити, покупець бачить The LP Express parcel terminal list is temporarily unavailable. Please try again later or choose another shipping method.

На OpenCart 4 блок LP Express parcel terminal з двома списками з'являється у вікні Shipping method options під опцією LP Express, коли покупець її вибирає. Кнопка Continue у цьому вікні не переходить далі без дійсного терміналу, з тими самими повідомленнями.

ID терміналу, назва та місто зберігаються із замовленням. Блок LP Express parcel terminal на сторінці замовлення в адмін-панелі (Sales > Orders, інформація про замовлення) показує місто, термінал і його Terminal ID. Спосіб доставки замовлення показує назву способу, двокрапку, місто та термінал (наприклад, LP Express parcel terminal: Kaunas, …), тож він відображається в деталях замовлення покупця, в електронних листах про замовлення та в рахунку. Якщо в замовленні немає терміналу, сторінка замовлення в адмін-панелі показує No parcel terminal was chosen for this order. Блок також показується для оформлених замовлень, коли розширення вимкнено. На OpenCart 4 він показується над History. OpenCart 4 зберігає одне замовлення для оформлення і оновлює його щоразу, коли покупець підтверджує знову, а термінал замовлення оновлюється разом із ним. Якщо покупець переводить це замовлення на інший спосіб доставки, його термінал видаляється.

Ліцензійний ключ

Розширення працює з ліцензійним ключем VibeFox з vibefox.net. Блок License — VibeFox LP Express — перший блок на сторінці Extensions > Extensions > Shipping > VibeFox LP Express > Edit, над налаштуваннями. Вставте ключ у поле License key і натисніть Activate. Після цього блок показує ключ у замаскованому вигляді, статус (наприклад, дату, до якої ліцензія активна, і ваш домен) та кнопки Check now, щоб знову перевірити статус, Change key, щоб ввести інший ключ, і Remove key, щоб видалити ключ із цього магазину. Нижче є рядок Product: opencart-shipping-lp-express і посилання Manage licenses and domains in your account, яке відкриває ваш обліковий запис vibefox.net. Змінювати ключ можуть лише адміністратори з правом Modify для цього розширення. Тексти блоку відповідають мові адмін-панелі (включено англійську та російську).

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

Один ключ працює на одному домені: адреса магазину з налаштувань OpenCart. Видалення ключа з магазину не звільняє слот домену. Звільніть слот у своєму обліковому записі vibefox.net.

Без активного ключа спосіб доставки LP Express не показується покупцям під час оформлення замовлення, і тариф не розраховується. Адміністратор, який увійшов в адмін-панель у тому самому браузері, все ще бачить спосіб доставки в магазині з позначкою (unlicensed — visible to admins only), тож ви можете налаштувати та перевірити розширення до купівлі ключа. В OpenCart 4 цей попередній перегляд недоступний: магазин не бачить вхід адміністратора, тож без активного ключа спосіб доставки приховано для всіх. Після того як ви один раз відкриєте сторінку Edit, на Dashboard адмін-панелі з'явиться нагадування. Закрийте його кнопкою ×, щоб приховати на 7 днів. Наявні замовлення не змінюються.

Коли ліцензія закінчується, розширення продовжує працювати, але для оновлень і підтримки потрібне продовження. Статус автоматично перевіряється знову, коли ви відкриваєте Dashboard адмін-панелі або сторінку Edit: раз на добу протягом перших 14 днів після введення ключа, потім раз на тиждень. Cron-завдання не потрібне. Під час видалення розширення ліцензійний ключ і статус ліцензії завжди видаляються.

Усунення несправностей

LP Express не з'являється під час оформлення замовлення: перевірте, що ліцензія активна і Enable/Disable увімкнено. Перевірте Geo zone (або що Ignore shipping zones увімкнено і країна дозволена). Відкрийте сторінку розширення: попередження пояснить, якщо ціна не встановлена або немає доступного поштового терміналу. Перевірте також обмеження ваги та Minimum cart total, а також те, що в товарів Requires Shipping встановлено в Yes. Якщо Debug log увімкнено, поле Log на сторінці розширення показує, чому спосіб доставки було приховано.

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

Список терміналів застарів: натисніть Save на сторінці розширення. Це перезавантажить список терміналів. Якщо ви використовуєте власний список, оновлюйте рядки самостійно.

Покупець не може продовжити: потрібно вибрати поштовий термінал. Якщо покупець бачить повідомлення, що список терміналів тимчасово недоступний, зараз немає жодного доступного терміналу. Додайте власний список.

Вибір терміналу не з'являється: вибір додається на крок способу доставки стандартного оформлення замовлення OpenCart (на OpenCart 4 у вікні Shipping method options) і перевірений зі стандартною темою. Сильно змінена тема або стороннє розширення оформлення замовлення може його не показувати.

У якій валюті ціни: у валюті за замовчуванням вашого магазину. Покупці, які платять в іншій валюті, бачать ціну, перераховану за курсом OpenCart.

Сторінка пише "Warning: You do not have permission to modify VibeFox LP Express!": ваша група адміністраторів може лише переглядати налаштування. Надайте групі право змінювати extension/shipping/vfd_lp_express (OpenCart 3) або extension/vfd_lp_express/shipping/vfd_lp_express (OpenCart 4) у розділі System > Users > User Groups.

Для розробників: адресу списку терміналів можна замінити налаштуванням vfd_lpex_feed_url (для тестів); для нього немає поля на сторінці налаштувань.

Видалення

Перейдіть до Extensions > Extensions, виберіть тип Shipping і натисніть Uninstall (червона кнопка −) поруч із VibeFox LP Express. Ліцензійний ключ і статус ліцензії цього розширення завжди видаляються. OpenCart завжди скидає Enable/Disable, Sort order, Tax class і Geo zone. Події розширення завжди видаляються, а кешований список терміналів очищується. Якщо Remove data on uninstall увімкнено, також видаляються налаштування, журнал, збережена копія списку терміналів і термінали незавершених оформлень замовлення. Якщо вимкнено, інші налаштування та збережена копія зберігаються й використовуються знову, коли ви повторно встановлюєте розширення. Термінал, збережений у замовленнях, ніколи не видаляється, і наявні замовлення зберігають термінал у своєму способі доставки.

На OpenCart 4, щоб видалити також файли розширення, після видалення перейдіть до Extensions > Installer і натисніть Uninstall (помаранчева кнопка −) поруч із VibeFox LP Express у списку встановлених розширень, а потім Delete (червона кнопка кошика), щоб видалити завантажений пакет.

LP Express є торговою маркою її власника. Це розширення не пов'язане з LP Express і не схвалене LP Express.