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: способ применения цены.

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.