VibeFox Packeta for WooCommerce — Помощь

Требования

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

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

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

API-ключ Packeta: найдите его в разделе клиента Packeta (client.packeta.com) в пункте Client support. Он состоит из 16 букв и цифр. Виджету он нужен, чтобы открыться при оформлении заказа, поэтому способ доставки показывается покупателям только после ввода API-ключа.

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

Установка

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

2. Нажмите Activate.

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

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

5. Введите API key Packeta и свои цены: хотя бы одну строку в Country prices (например * Default) или Fallback cost. Сохраните. На странице будет показано, принял ли Packeta ключ.

6. Добавьте VibeFox Packeta в зоны доставки для Чехии, Словакии, Венгрии или Румынии в разделе WooCommerce > Settings > Shipping > Shipping zones или включите Ignore shipping zones.

Настройка

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

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

Способ предлагается только для стран собственной сети пунктов выдачи Packeta: CZ, SK, HU и RO. Над настройками страница показывает результат проверки API-ключа и предупреждения о проблемах, например об отсутствии API-ключа, цены или о выбранных странах вне сети Packeta.

Все цены и лимиты принимают запятую или точку в качестве десятичного разделителя (4,99 или 4.99). Неверное число отклоняется с сообщением, и сохраняется прежнее значение.

Общие

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

Name: название способа доставки, которое видит покупатель. Зона может заменить его своим Title. По умолчанию: Packeta pickup point.

API key: ваш API-ключ Packeta из раздела client.packeta.com > Client support. Можно вставить и 32-символьный API-пароль: сохраняются только его первые 16 символов, то есть API-ключ. API-ключ публичный: он передаётся в браузер покупателя, чтобы открыть виджет. При сохранении нового ключа он проверяется по каналу перевозчиков Packeta, и страница показывает Packeta API key verified или сообщение, что Packeta отклонил ключ. Если проверку выполнить не удалось, ключ сохраняется и проверяется снова при следующем сохранении.

Widget language: язык виджета пунктов выдачи. Store / visitor language (по умолчанию) следует языку страницы. Можно зафиксировать чешский, словацкий, венгерский, румынский, английский, немецкий, польский или украинский.

Pickup point types: какие пункты Packeta предлагает виджет.

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

Цены

У Packeta нет публичного API тарифов. Цены берутся из этой таблицы и вводятся в валюте магазина.

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

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

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

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

Доступность

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

Maximum weight (kg): скрывает способ, если корзина весит больше. По умолчанию: 15. Пункты выдачи и Z-BOX Packeta обычно принимают посылки до 15 кг; уточните в своём договоре с Packeta. Пустое значение или 0 означает отсутствие ограничения.

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

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

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

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

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

Debug log: записывает расчёты тарифов и выбор пунктов выдачи в WooCommerce > Status > Logs (источник «vfd-packeta»). Персональные данные покупателей и API-ключ не записываются. Неудачные проверки API-ключа всегда записываются. Выключите журнал, когда закончите.

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

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

Когда покупатель вводит адрес доставки, WooCommerce запрашивает у плагина тариф. Плагин проверяет условия: страна доставки входит в сеть Packeta, есть API-ключ, вес корзины, минимальный промежуточный итог корзины и исключённые классы доставки. Цена берётся из таблицы стран, затем из запасной стоимости. Если цены нет, способ скрывается. Если применяется бесплатная доставка, покупатель видит способ без платы.

Когда покупатель выбирает способ Packeta, под ним появляется кнопка Choose pickup point. Она открывает в браузере покупателя официальный виджет Packeta со страной назначения, весом корзины, выбранными типами пунктов и языком виджета. После выбора пункта его название и адрес отображаются под способом, а кнопка меняется на Change pickup point. Выбор запоминается в сеансе покупателя при обновлении оформления заказа и перезагрузке страницы.

Ваш сервер при оформлении заказа ничего не запрашивает у Packeta. Скрипт виджета загружается с widget.packeta.com. Если он заблокирован (блокировщиком рекламы или приватности, политикой безопасности контента или сбоем Packeta), покупатель видит сообщение «The Packeta pickup point widget could not be loaded. Please reload the page or choose another shipping method.»

Способ работает в классическом оформлении заказа и в блоках «Корзина» и «Оформление заказа». Он совместим с высокопроизводительным хранилищем заказов WooCommerce (HPOS).

Цены Packeta в реальном времени не запрашиваются; они берутся из вашей таблицы. Плагин не создаёт отправления Packeta, не печатает этикетки и не отслеживает посылки, а также не предлагает доставку на дом и пункты выдачи партнёрских перевозчиков «из коробки». Передавайте ID пункта выдачи из заказа в Packeta обычным способом, например импортом в client.packeta.com.

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

Пункт выдачи обязателен. Если покупатель оформляет заказ без выбора пункта, оформление останавливается с сообщением «Please choose a Packeta pickup point.». Если выбранный пункт находится в другой стране, чем адрес доставки, оформление останавливается с сообщением «The selected Packeta pickup point is not in your shipping country. Please choose a pickup point again.». Обе проверки выполняются на сервере, как в классическом, так и в блочном оформлении заказа. Плагин не проверяет ID пункта в Packeta; он лишь проверяет, что пункт выбран и что его страна совпадает.

Пункт сохраняется вместе с заказом при его создании:

Экран заказа в админ-панели: Packeta pickup point с названием, адресом, Pickup point ID и страной под адресом доставки. Если у заказа Packeta нет пункта, экран показывает «No pickup point was selected for this order.».

Страница благодарности и просмотр заказа: Packeta pickup point: с названием и адресом.

Письма о заказе: название и адрес пункта в HTML- и текстовых письмах. Письма администратору также содержат Pickup point ID.

В базе данных пункт хранится в метаданных заказа _vfd_pckt_point_id, _vfd_pckt_point_name (название и адрес) и _vfd_pckt_point_country.

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

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

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

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

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

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

Packeta не появляется при оформлении заказа: проверьте, что лицензия активна, включён Enable/Disable, введён API key и страна назначения — CZ, SK, HU или RO. Проверьте, что для страны задана цена (строка страны, строка * Default или Fallback cost), лимиты веса и промежуточного итога, Excluded shipping classes, а также что способ добавлен в соответствующую зону (или включён Ignore shipping zones). Страница настроек вверху показывает проблемы конфигурации. Включите Debug log, чтобы увидеть причину в WooCommerce > Status > Logs.

Packeta отклонил API-ключ: заново скопируйте API-ключ из client.packeta.com > Client support и сохраните. До этого виджет не может открыться при оформлении заказа.

Виджет не открывается: скрипт Packeta заблокирован блокировщиком рекламы или приватности, политикой безопасности контента или сбоем Packeta. Разрешите widget.packeta.com в политике безопасности контента. Разработчики могут изменить URL скрипта фильтром vfd_pckt_widget_url.

Доставка бесплатна по ошибке: проверьте в Country prices строки с Price 0, особенно строку * Default, добавленную кнопкой + Add country и оставленную незаполненной.

Другие страны или перевозчики: из коробки способ работает для CZ, SK, HU и RO. Разработчики могут добавить страны фильтром vfd_pckt_countries и передать ID перевозчиков в виджет фильтром vfd_pckt_widget_options.

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

Удаление

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

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