VibeFox DPD Pickup for WooCommerce — Помощь

Требования

WordPress: 5.8 или новее.

WooCommerce: 7.0 или новее, установлен и активен. Плагин не активируется без него.

PHP: 8.0 или новее.

Учётные данные DPD Baltic (Литва, Латвия, Эстония): список пунктов выдачи берётся из веб-сервиса DPD Baltic. Нужны имя пользователя и пароль API, которые DPD выдаёт бизнес-клиентам. Уточните их у своего менеджера DPD или в службе поддержки DPD вашей страны. Одна учётная запись показывает пункты выдачи Литвы, Латвии и Эстонии.

DPD Словакия: публичный поиск parcelshop DPD Словакия не требует учётных данных.

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

Установка

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

2. Нажмите Activate.

3. Откройте настройки: WooCommerce > Settings > Shipping > VibeFox DPD Pickup или нажмите Settings под названием плагина на странице Plugins.

4. Введите лицензионный ключ VibeFox в блоке лицензии в верхней части страницы и нажмите Activate.

5. Выберите API DPD. Для DPD Литва, Латвия или Эстония введите имя пользователя и пароль API. Укажите цены по странам и сохраните настройки. Нажмите Refresh pickup points, чтобы проверить подключение (см. раздел «Настройка»).

6. Добавьте VibeFox DPD Pickup в зоны доставки в разделе WooCommerce > Settings > Shipping > Shipping zones или включите Ignore shipping zones.

Настройка

Все настройки находятся на одной странице: WooCommerce > Settings > Shipping > VibeFox DPD Pickup. Они действуют во всех зонах доставки. Когда вы добавляете способ в зону, в окне зоны есть только одно поле:

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

Предупреждения над настройками сообщают, если имя пользователя или пароль DPD Baltic не заполнены и если не задана ни одна цена. Каждый раз при сохранении настроек кэш пунктов выдачи очищается.

Общие

Enable/Disable: включает или выключает способ во всех зонах сразу.

Name: название способа доставки, которое видит покупатель на странице оформления заказа. По умолчанию: DPD Pickup Point.

Tax status: Taxable добавляет налог WooCommerce к стоимости доставки, None не добавляет.

Список пунктов выдачи DPD

Пункты выдачи загружаются из DPD и кэшируются на 24 часа.

DPD API: компания DPD, в которой открыт ваш аккаунт. Балтийские аккаунты используют веб-сервис своей страны.

API username (Baltic): ваше имя пользователя для веб-сервиса DPD Baltic. Для DPD Словакия не нужно.

API password (Baltic): ваш пароль для веб-сервиса DPD Baltic. Для DPD Словакия не нужен.

Pickup points: кнопка Refresh pickup points очищает кэш и сразу загружает пункты выдачи из DPD: Литвы, Латвии и Эстонии для Baltic API или тестовый поиск в Братиславе для DPD Словакия. Результат выводится по каждой стране. Сначала сохраните настройки.

Цены

Стоимость доставки задаётся фиксированной ценой для каждой страны в валюте магазина. Цены DPD через API не запрашиваются.

Country prices: по одной строке на страну: CC:price, например EE:3.50. Допускается десятичная запятая. По умолчанию: SK:3.50, LT:4.00, LV:4.00, EE:4.00.

Fallback cost: цена для стран, которых нет в Country prices. По умолчанию: 5.00. Оставьте поле пустым, чтобы предлагать способ только в перечисленных странах.

Calculation type: Per order взимает цену один раз. Per item (price x quantity) умножает её на количество товаров в корзине.

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

Доступность

Способ также скрывается, если DPD не возвращает пункты выдачи для адреса покупателя или если API DPD недоступен, так как заказ нельзя доставить без пункта выдачи.

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

Max weight (kg): более тяжёлые корзины не видят этот способ. По умолчанию: 31.5. 0 означает отсутствие ограничения. Проверьте ограничения по весу посылок для пунктов выдачи и постаматов DPD Pickup в вашей стране.

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

Excluded shipping classes: способ скрывается, если в корзине есть товар одного из этих классов доставки WooCommerce.

Ignore shipping zones: предлагать способ для стран, указанных ниже, даже если зона доставки покупателя его не содержит. Если выключено, способ добавляется в зоны доставки обычным образом.

Countries: страны назначения для этого режима. Оставьте поле пустым, чтобы включить все страны. Используется только вместе с Ignore shipping zones.

Выбор пункта выдачи

City order: сначала показывать крупные города (Таллин, Рига, Вильнюс, Братислава и другие). По умолчанию включено.

City list width: ширина списка городов в CSS, например 100% или 300px. По умолчанию: 100%.

Pickup point list width: ширина списка пунктов выдачи в CSS, например 100% или 400px. По умолчанию: 100%.

Дополнительно

Debug log: записывает запросы к API и шаги оформления заказа в WooCommerce > Status > Logs, источник vfd-dpd-pickup. Ошибки API записываются всегда, даже если эта опция выключена. Учётные данные никогда не записываются.

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

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

Когда покупатель вводит адрес доставки, WooCommerce запрашивает у плагина цену. Плагин проверяет вес корзины, минимальную сумму заказа и исключённые классы доставки, берёт цену для страны (или запасную цену) и применяет бесплатную доставку, если сумма заказа достаточна. Затем он загружает пункты выдачи DPD для адреса. Если DPD не возвращает ни одного пункта, не отвечает или учётные данные Baltic не заполнены, способ скрывается.

Список пунктов выдачи кэшируется на 24 часа. Неудачный запрос запоминается на 5 минут, поэтому сбой DPD никогда не замедляет оформление заказа. Тайм-аут API составляет 15 секунд.

Способ работает в классическом оформлении заказа и в блоках «Корзина» и «Оформление заказа». Он совместим с High-Performance Order Storage (HPOS) WooCommerce.

Плагин не запрашивает цены DPD, не создаёт отправления DPD, не печатает этикетки, не формирует манифесты, не заказывает забор курьером, не отслеживает посылки и не показывает карту. Поддерживаются только веб-сервис DPD Baltic и поиск parcelshop DPD Словакия.

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

Когда покупатель выбирает DPD Pickup, под способом доставки появляются список городов и список пунктов выдачи. Город из адреса покупателя выбирается автоматически. Для DPD Словакия покупатель сначала вводит город и почтовый индекс, а затем видит ближайшие пункты. Выбор пункта выдачи обязателен. Сервер проверяет, что пункт относится к стране и адресу покупателя, поэтому подделанный или устаревший выбор отклоняется.

Выбранный пункт сохраняется в заказе. Он показывается на экране заказа под адресом доставки, на странице благодарности, в разделе My account > Orders и в письмах о заказе (в HTML и в текстовой версии) под названием DPD pickup point. Название, сохранённое в заказе, берётся из DPD, а не из браузера.

На экране заказа нажмите Edit рядом с пунктом выдачи, выберите город и другой пункт. Пункт проверяется по списку DPD для адреса заказа. Чтобы изменить пункт, в заказе должны быть город и почтовый индекс доставки.

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

Плагин работает с лицензионным ключом VibeFox, который можно получить на vibefox.net. Блок лицензии находится в верхней части раздела WooCommerce > Settings > Shipping > VibeFox DPD Pickup. Вставьте ключ в поле License key и нажмите Activate. В блоке отображается статус, например дата, до которой лицензия действует, и ваш домен. С помощью Check now можно снова проверить статус, Change key — ввести другой ключ, а Remove key — удалить ключ с этого сайта. Ссылка Manage licenses and domains in your account открывает ваш аккаунт на vibefox.net.

Один ключ работает на одном домене. Удаление ключа с сайта не освобождает слот домена. Освободите его в своём аккаунте на vibefox.net.

Без активного ключа DPD Pickup не показывается покупателям на оформлении заказа. Вошедшие в систему администраторы магазина видят его, отмеченным как (unlicensed — visible to admins only), чтобы вы могли настроить и проверить плагин до покупки ключа. Напоминание появляется на странице Plugins и на страницах WooCommerce. Существующие заказы не затрагиваются.

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

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

DPD Pickup не появляется на оформлении заказа: проверьте, что лицензия активна, что Enable/Disable включено и способ добавлен в зону страны покупателя (или что Ignore shipping zones включено и страна разрешена). Проверьте предупреждения вверху страницы настроек и нажмите Refresh pickup points. Проверьте ограничения по весу и сумме заказа, исключённые классы доставки и наличие цены для страны (или запасной цены).

«Login failed» после Refresh pickup points: DPD отклонил учётные данные Baltic, поэтому пункты выдачи загрузить нельзя. Проверьте имя пользователя и пароль API у DPD.

DPD Словакия не показывает пункты: пункты появляются после того, как покупатель введёт город и почтовый индекс. DPD показывает только пункты в радиусе 50 км от этого адреса.

Поиск причины: включите Debug log. Каждое решение записывается в WooCommerce > Status > Logs, источник vfd-dpd-pickup. Ошибки API записываются всегда. Имена пользователей и пароли API никогда не записываются в журнал.

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

Удаление

Деактивация плагина сохраняет все настройки. Она очищает только кэш пунктов выдачи. Чтобы удалить плагин, деактивируйте его и удалите на странице Plugins. Лицензионный ключ и статус лицензии этого плагина всегда удаляются, как и кэш пунктов выдачи. Настройки и способы зон удаляются только если была включена опция Remove data on uninstall. В противном случае они сохраняются для повторной установки. Пункт выдачи, сохранённый в заказах, никогда не удаляется, а существующие заказы сохраняют свои строки доставки.

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