VibeFox GLS ParcelShop for WooCommerce — Допомога

Вимоги

WordPress: 5.8 або новіша версія.

WooCommerce: 7.0 або новіша версія, встановлений і активний. Без нього плагін не активується.

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

GLS: плагін не використовує і не потребує облікового запису GLS або ключа API. Карта пунктів ParcelShop є публічною. Для відправлення посилок до обраних пунктів ParcelShop потрібен договір із GLS.

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

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

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

2. Натисніть Activate.

3. Відкрийте налаштування: WooCommerce > Settings > Shipping > VibeFox GLS ParcelShop або натисніть Settings під назвою плагіна на сторінці Plugins.

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

5. Вкажіть назву та свої ціни: принаймні один рядок у Country prices (наприклад * Default) або Fallback cost (див. Налаштування).

6. Додайте VibeFox GLS ParcelShop до зони доставки в WooCommerce > Settings > Shipping > Shipping zones або увімкніть Ignore shipping zones.

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

Усі налаштування розташовані на одній сторінці: WooCommerce > Settings > Shipping > VibeFox GLS ParcelShop. Вони діють для всіх зон доставки. Коли ви додаєте спосіб до зони, у вікні зони є лише одне поле:

Title (zone): назва способу доставки, яку бачить покупець у цій зоні. Залиште поле порожнім, щоб використовувати загальну Name.

Попередження у верхній частині сторінки налаштувань вказують на проблеми конфігурації, наприклад коли не задано жодної ціни або жодна з обраних країн не входить до карти GLS. Некоректні числа відхиляються з повідомленням, і зберігається попереднє значення.

Загальні

У розділі перелічено країни, які охоплює карта GLS. Спосіб доставки не пропонується для інших країн призначення.

Enable/Disable: вмикає або вимикає спосіб доставки у всіх зонах одночасно. За замовчуванням: увімкнено.

Name: назва способу доставки, яку бачить покупець. Зона може замінити її власним Title. За замовчуванням: GLS ParcelShop.

Tax status: Taxable додає податок WooCommerce до вартості доставки, None не додає. За замовчуванням: Taxable.

Ціни

Ціни вводяться у валюті вашого магазину. Десяткові знаки можна вводити через кому або крапку (4,99 або 4.99).

Calculation type: як застосовується ціна.

Per order: ціна стягується один раз за замовлення (за замовчуванням).

Per item (price x quantity): ціна множиться на кількість товарів у кошику. Віртуальні товари не враховуються.

Country prices: таблиця з одним рядком на кожну країну призначення. Натисніть + Add country, щоб додати рядок, і хрестик, щоб видалити його. Кожен рядок містить Country, Price і п'ять вагових колонок: XS до 1 кг, S 1–2 кг, M 2–3 кг, L 3–5 кг і XL понад 5 кг. Використовується колонка, що відповідає вазі кошика. Вагова колонка, залишена на 0, використовує колонку Price. Рядок * Default застосовується до країн, які не мають власного рядка. Нові рядки починаються з 0 в усіх колонках, а рядок, де всі ціни дорівнюють 0, означає безкоштовну доставку, тож заповніть ціни перед збереженням.

Fallback cost: ціна, яка використовується, коли в таблиці немає рядка для країни призначення і немає рядка * Default. Залиште поле порожнім, щоб приховати спосіб доставки для таких країн.

Free shipping from: сума кошика (після знижок, без податків), починаючи з якої доставка до GLS ParcelShop безкоштовна. Залиште поле порожнім, якщо доставка ніколи не є безкоштовною.

Доступність

Minimum weight (kg): приховує спосіб доставки, коли кошик важить менше. Вага перераховується з одиниці ваги вашого магазину. Порожнє поле або 0 означає відсутність обмеження.

Maximum weight (kg): приховує спосіб доставки, коли кошик важить більше. За замовчуванням: 20. Пункти GLS ParcelShop зазвичай приймають посилки до 20 кг, тож перевірте це у своєму договорі з GLS. Порожнє поле або 0 означає відсутність обмеження.

Minimum cart subtotal: пропонує спосіб доставки, лише коли сума кошика (після знижок, без податків) досягає цієї суми. Залиште поле порожнім, якщо мінімуму немає.

Excluded shipping classes: приховує спосіб доставки, коли в кошику є товар одного з цих класів доставки WooCommerce.

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

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

Додатково

Debug log: записує розрахунок тарифів і вибір пунктів ParcelShop у WooCommerce > Status > Logs (джерело vfd-gls-parcelshop). Персональні дані покупців не записуються. Вимкніть журнал, коли закінчите.

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

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

Коли покупець вводить адресу доставки, WooCommerce запитує у плагіна тариф. Плагін спочатку перевіряє умови: країна доставки входить до карти GLS, вага кошика, мінімальна сума кошика та виключені класи доставки. Якщо сума кошика досягає Free shipping from, доставка безкоштовна. Інакше ціна береться з рядка країни (або рядка * Default) і вагової колонки, або з Fallback cost. Якщо ціну не знайдено, спосіб доставки приховується.

Коли покупець обирає GLS ParcelShop, під способом доставки з'являється кнопка Select GLS ParcelShop. Вона відкриває офіційну карту пунктів GLS ParcelShop для країни доставки. Після вибору пункту показуються його назва та адреса, а кнопка змінюється на Change ParcelShop. Вибір зберігається в сесії покупця, тож залишається після оновлення сторінки оформлення або її перезавантаження.

Під час оформлення замовлення плагін перевіряє, що пункт видачі вибрано і що він знаходиться в країні доставки. Інакше покупець бачить Будь ласка, оберіть пункт GLS ParcelShop. або Обраний пункт GLS ParcelShop не знаходиться у вашій країні доставки. Будь ласка, оберіть пункт ParcelShop знову., і замовлення не оформлюється. Якщо скрипт карти GLS не вдається завантажити, покупець бачить повідомлення перезавантажити сторінку або обрати інший спосіб доставки.

Карта GLS працює у браузері покупця. На сторінці оформлення замовлення плагін завантажує скрипт карти GLS з map.gls-croatia.com, а карта завантажує з GLS дані пунктів і плитки карти. GLS отримує звичайні дані запиту відвідувача (IP-адресу, браузер). З вашого сервера до GLS нічого не надсилається.

Спосіб доставки працює на класичному оформленні замовлення та в блоках Кошик і Оформлення замовлення. Він сумісний із WooCommerce High-Performance Order Storage (HPOS).

Плагін не отримує актуальних тарифів GLS, не створює відправлень GLS, не друкує етикетки та не відстежує посилки. На вашому сервері немає списку пунктів ParcelShop, тож він не може перевірити ID пункту в GLS. Передайте ID пункту з замовлення до GLS звичним способом (MyGLS, ваше програмне забезпечення GLS або інший плагін).

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

Обраний пункт ParcelShop зберігається разом із замовленням: його ID, назва з адресою та країна.

Екран замовлення в адмінці: назва та адреса пункту ParcelShop з його ID і країною відображаються під адресою доставки. Якщо в замовленні GLS ParcelShop немає пункту, екран показує Для цього замовлення пункт ParcelShop не обрано.

Сторінки покупця: пункт ParcelShop відображається на сторінці подяки та на сторінці перегляду замовлення в обліковому записі покупця.

Листи: пункт ParcelShop додається до листів про замовлення, у HTML і простому тексті. Листи адміністратору магазину також містять ID пункту ParcelShop.

Розробники можуть отримати пункт ParcelShop з метаданих замовлення _vfd_glps_parcelshop_id, _vfd_glps_parcelshop_name та _vfd_glps_parcelshop_country.

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

Плагін працює з ліцензійним ключем VibeFox з vibefox.net. Блок ліцензії розташований угорі сторінки WooCommerce > Settings > Shipping > VibeFox GLS ParcelShop. Вставте ключ у поле License key і натисніть Activate. Блок показує статус, наприклад дату, до якої ліцензія активна, і ваш домен. Натисніть Check now, щоб перевірити статус знову, Change key, щоб ввести інший ключ, і Remove key, щоб видалити його з цього сайту. Посилання Manage licenses and domains in your account відкриває ваш обліковий запис vibefox.net.

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

Без активного ключа GLS ParcelShop не відображається покупцям на сторінці оформлення замовлення. Менеджери магазину, які ввійшли в систему, все одно бачать його, позначеним як (без ліцензії — видно лише адміністраторам), щоб ви могли налаштувати й протестувати плагін до купівлі ключа. Нагадування з'являється на сторінці Plugins і на сторінках WooCommerce. Наявні замовлення не змінюються.

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

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

GLS ParcelShop не з'являється на сторінці оформлення замовлення: перевірте, що ліцензія активна, що Enable/Disable увімкнено і спосіб доставки додано до зони країни покупця (або що Ignore shipping zones увімкнено і країна дозволена). Перевірте, що країна призначення входить до країн карти GLS і для неї є ціна (рядок країни, рядок * Default або Fallback cost). Перевірте обмеження ваги, Minimum cart subtotal та Excluded shipping classes. Увімкніть Debug log, щоб побачити причину в WooCommerce > Status > Logs.

Карта не відкривається: покупець бачить «Не вдалося завантажити карту GLS ParcelShop...», коли скрипт GLS заблоковано, наприклад блокувальником реклами чи конфіденційності, політикою безпеки вмісту або збоєм у GLS. Дозвольте map.gls-croatia.com у своїй політиці безпеки вмісту.

Доставка помилково безкоштовна для країни: перевірте рядок цієї країни в Country prices. Рядок, де Price і всі вагові колонки дорівнюють 0, дає безкоштовну доставку.

Таблицю або поле не збережено: значення не є допустимим числом. Повідомлення у верхній частині сторінки вказує на значення. Використовуйте цифри з комою або крапкою як десятковим роздільником.

Фільтри для розробників: vfd_glps_map_countries змінює список країн карти GLS, vfd_glps_widget_url змінює URL скрипта карти GLS.

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

Видалення

Деактивація плагіна зберігає всі дані. Щоб видалити його, деактивуйте і видаліть на сторінці Plugins. Ліцензійний ключ і статус ліцензії цього плагіна завжди видаляються разом із застарілим кешем та файлом журналу версії 1.0. Налаштування та екземпляри способу доставки в зонах видаляються лише якщо було увімкнено Remove data on uninstall. Інакше вони зберігаються для повторного встановлення. Пункт ParcelShop, збережений у замовленнях, завжди зберігається, а наявні замовлення зберігають свої рядки доставки.

GLS — торговельна марка її власника. Цей плагін не пов'язаний із GLS і не схвалений GLS.