VibeFox GLS ParcelShop for PrestaShop — Помощь

Требования

PrestaShop: 8.0–9.x. Выбор пункта выдачи работает в темах Classic и Hummingbird.

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

GLS: модуль не использует и не требует учётной записи GLS или ключа API. Карта пунктов выдачи ParcelShop публичная. Для отправки посылок в выбранные пункты выдачи нужен договор с GLS.

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

Установка

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

2. Когда загрузка завершится, нажмите Configure или позже найдите VibeFox GLS ParcelShop в списке модулей и нажмите Configure.

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

4. Задайте цены: хотя бы одну строку в Country prices (например, * Default) или Fallback cost (см. раздел «Настройка»), и нажмите Save.

При установке модуль создаёт перевозчика GLS ParcelShop с текстом срока доставки Delivery to a GLS ParcelShop of your choice. Перевозчик назначается всем группам покупателей и зонам стран карты GLS (в стандартном магазине обычно Europe и Europe (non-EU)). Зоны, группы покупателей, срок доставки и логотип можно изменить в разделе Shipping > Carriers. Цены там не задавайте: цена всегда берётся из модуля.

Настройка

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

Предупреждения вверху страницы указывают на проблемы настройки: перевозчик не найден, модулю не известна единица веса магазина (задайте kg, g, lb или oz в International > Localization, Local units), не задана ни одна цена, или некоторые либо все выбранные Countries (ignore zones mode) не покрыты картой GLS. Неверное или отрицательное число отклоняется с сообщением, которое называет поле, и сохраняется предыдущее значение. Остальные поля всё равно сохраняются.

General

В разделе перечислены страны, покрытые картой GLS. Перевозчик не предлагается для других стран назначения.

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

Name: название способа доставки, которое видит покупатель (название перевозчика). По умолчанию: GLS ParcelShop. Обязательное поле, не более 64 символов.

Tax status: налоговое правило перевозчика. None означает, что доставка не облагается налогом. Выберите налоговое правило, чтобы доставка облагалась налогом.

Prices

Цены вводятся в основной валюте магазина без налогов. Десятичные знаки можно указывать через запятую или точку (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 применяется к странам без собственной строки. Новые строки начинаются с * Default и 0 во всех колонках, а строка, где все цены равны 0, даёт бесплатную доставку, поэтому выберите страну и заполните цены перед сохранением. Если какое-либо значение в таблице не является допустимым числом, вся таблица не сохраняется, а сообщение перечисляет неверные значения.

Fallback cost: цена, которая используется, когда в таблице нет строки для страны назначения и нет строки * Default. Оставьте поле пустым, чтобы скрывать перевозчика для таких стран.

Free shipping from: сумма корзины (после скидок, без налогов), начиная с которой доставка GLS ParcelShop бесплатна. Оставьте поле пустым, если доставка никогда не бывает бесплатной.

Availability

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

Maximum weight (kg): скрывает перевозчика, если корзина весит больше. По умолчанию: 20. Пункты выдачи GLS обычно принимают посылки до 20 кг, поэтому уточните это в договоре с GLS. Пустое значение или 0 означает отсутствие ограничения. Если минимум больше максимума, оба веса отклоняются с сообщением, а предыдущие значения сохраняются.

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

Ignore shipping zones: когда включено, перевозчик привязывается ко всем зонам, включая отключённые, и предлагается для стран, выбранных ниже, даже если их нет в его зонах. Зоны, созданные позже, тоже привязываются. Когда вы выключаете опцию, перевозчик возвращает зоны, которые были у него раньше, и предлагается только в них. По умолчанию: выключено.

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

Advanced

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

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

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

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

Когда PrestaShop показывает шаг доставки, он запрашивает у модуля цену GLS ParcelShop. Учитываются только физические товары: виртуальные товары не добавляют вес и не входят в сумму корзины. Модуль сначала проверяет условия: страна доставки покрыта картой GLS (и выбрана в Countries (ignore zones mode), когда этот режим включён), вес корзины и минимальная сумма корзины. Если сумма корзины достигает Free shipping from, доставка бесплатная. Иначе цена берётся из строки страны (или строки * Default) и весовой колонки либо из Fallback cost. Если цена не найдена, перевозчик скрывается.

Когда покупатель выбирает GLS ParcelShop, под перевозчиком появляется блок GLS ParcelShop с кнопкой Select GLS ParcelShop. Она открывает официальную карту пунктов выдачи GLS для страны доставки. После выбора пункта выдачи показываются его название и адрес, а кнопка меняется на Change ParcelShop. Выбор сохраняется в корзине, поэтому он остаётся после обновления шага доставки или перезагрузки страницы. Если адрес доставки меняется на другую страну, покупателю нужно выбрать пункт выдачи заново.

Когда покупатель нажимает Continue на шаге доставки, модуль проверяет, что пункт выдачи выбран и находится в стране доставки. Иначе покупатель видит Please select a GLS ParcelShop. или The selected GLS ParcelShop is not in your shipping country. Please choose a ParcelShop again. и остаётся на шаге доставки. Если пункт выдачи не удаётся сохранить, покупатель видит The ParcelShop could not be saved. Please try again. Если скрипт карты GLS не загружается, покупатель видит сообщение перезагрузить страницу или выбрать другой способ доставки.

Карта GLS работает в браузере покупателя. При оформлении заказа модуль загружает скрипт карты с map.gls-croatia.com, а карта загружает данные пунктов выдачи и фрагменты карты с серверов GLS. GLS получает обычные данные запроса посетителя (IP-адрес, браузер). С вашего сервера в GLS ничего не отправляется.

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

Модуль не получает актуальные тарифы GLS, не создаёт отправления GLS, не печатает этикетки и не отслеживает посылки. На вашем сервере нет списка пунктов выдачи, поэтому он не может проверить ID пункта выдачи в GLS. Передайте ID пункта выдачи из заказа в GLS обычным для вас способом (MyGLS, ваше ПО GLS или другой модуль).

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

При оформлении заказа пункт выдачи из корзины сохраняется вместе с заказом: его ID, название с адресом и страна. Далее он не меняется вместе с корзиной.

Страница заказа в админке: блок GLS ParcelShop показывает название и адрес пункта выдачи, а также ParcelShop ID и страну. Если у заказа GLS ParcelShop нет пункта выдачи, блок показывает No ParcelShop was selected for this order.

Страницы покупателя: пункт выдачи отображается на странице подтверждения заказа и на странице сведений о заказе в личном кабинете покупателя.

Письма: пункт выдачи добавляется к названию перевозчика в письме с подтверждением заказа, которое получает покупатель. Письмо о новом заказе продавцу (модуль Mail alerts) также содержит ID пункта выдачи.

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

Модуль работает с лицензионным ключом VibeFox с vibefox.net. Блок лицензии License — VibeFox GLS ParcelShop — первый блок на странице Modules > Module Manager > VibeFox GLS ParcelShop > Configure, над настройками. Введите ключ в License key и нажмите Activate. После этого блок показывает ключ в замаскированном виде, статус (например, дату, до которой действует лицензия, и ваш домен) и кнопки Check now для повторной проверки статуса, Change key для ввода другого ключа и Remove key для удаления ключа из этого магазина. Ниже находятся строка Product: presta-shipping-gls-parcelshop и ссылка 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.

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

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

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

GLS ParcelShop не появляется при оформлении заказа: проверьте, что лицензия активна и Enable/Disable включено. В Shipping > Carriers проверьте, что перевозчик охватывает зону страны покупателя и группу покупателя (или включите Ignore shipping zones и проверьте Countries (ignore zones mode)). Проверьте, что страна назначения входит в страны карты GLS и для неё есть цена (строка страны, строка * Default или Fallback cost). Проверьте ограничения по весу и Minimum cart subtotal. Товары также могут быть ограничены определёнными перевозчиками на странице товара. Включите Debug log и посмотрите поле Log, чтобы узнать причину.

Карта не открывается: покупатель видит "The GLS ParcelShop map could not be loaded...", когда скрипт GLS заблокирован, например рекламным или приватным блокировщиком, политикой безопасности контента (CSP) или из-за сбоя GLS. Разрешите map.gls-croatia.com в вашей политике безопасности контента.

Доставка по ошибке бесплатна для страны: проверьте строку этой страны в Country prices. Строка, где Price и все весовые колонки равны 0, даёт бесплатную доставку.

Таблица или поле не сохранились: значение не является допустимым числом. Сообщение вверху страницы называет значение. Используйте цифры с запятой или точкой в качестве десятичного разделителя.

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

У заказа нет пункта выдачи, а в журнале сказано, что пункт выдачи из корзины уже сохранён в другом заказе: одна корзина стала двумя заказами. Первый заказ сохраняет пункт выдачи. Передайте второй заказ в GLS вручную.

Удаление

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

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