VibeFox SmartPost for WooCommerce — Помощь

Требования

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

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

PHP: 8.0 или новее, с расширением SimpleXML (входит в большинство установок PHP).

SmartPost: аккаунт API и ключ не нужны. Список пунктов выдачи берётся из открытого списка мест SmartPost. У SmartPost нет публичного API тарифов, поэтому вы вводите свои (договорные) тарифы. Отправления создаются в вашем бизнес-аккаунте SmartPost (SmartPosti).

Страны: пункты выдачи SmartPost есть в Эстонии, Латвии, Литве и Финляндии. Для других стран назначения способ доставки не отображается.

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

Установка

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

2. Нажмите Activate.

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

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

5. Проверьте таблицу тарифов (стандартные тарифы уже заполнены), размеры коробок и статус пунктов выдачи вверху страницы.

6. Добавьте VibeFox SmartPost в зону или зоны, где есть Эстония, Латвия, Литва и/или Финляндия, в разделе WooCommerce > Settings > Shipping > Shipping zones, или включите Ignore shipping zones и выберите страны.

Настройки

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

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

Вверху страницы уведомления показывают проблемы и статус пунктов выдачи. Красное уведомление появляется, когда цена не задана: тогда способ не отображается при оформлении заказа. Блок Pickup points available at checkout показывает для каждой страны, сколько пунктов выдачи и в скольких городах доступно. Он также сообщает, когда используется сохранённая копия списка, потому что список SmartPost сейчас недоступен, когда страну не удалось загрузить вовсе и когда для страны не заданы тарифы. Кнопка Refresh pickup point lists now заново загружает списки и показывает новые цифры.

Общие

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

Method title: название способа доставки, которое видят покупатели. Title способа в зоне его заменяет. По умолчанию: SmartPost parcel locker.

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

Тарифы (в валюте вашего магазина; десятичные значения можно писать как 3.50 или 3,50)

Price table: по одной строке для каждой страны (Эстония, Латвия, Литва, Финляндия) с ценой для каждого размера коробки S, M, L и XL и столбцом Free from. 0 означает бесплатно. Пустая ячейка означает, что этот размер коробки не предлагается: способ скрывается, когда посылке нужна эта коробка. Страна, у которой все ячейки пустые, не обслуживается. Free from — сумма корзины, начиная с которой SmartPost бесплатен в этой стране; оставьте пустым, если бесплатной доставки нет. Цены, которые не являются числами, сообщаются после сохранения и остаются пустыми. Стандартные тарифы: Эстония 3.50, Латвия 4.00, Литва 4.00, Финляндия 5.00 для каждой коробки.

Box sizes (cm): внутренний размер каждой коробки, наименьшая сторона первой (Side 1 (smallest), Side 2, Side 3 (largest)). Стороны товара сортируются так же и сравниваются попарно, используется наименьшая подходящая коробка. Товары без размеров помещаются в коробку S. Посылка, которая не помещается ни в одну коробку, скрывает способ. Размеры товара переводятся из единицы измерения магазина. Стандартные размеры: S 12 x 36 x 60, M 20 x 36 x 60, L 36 x 38 x 60, XL 36 x 60 x 60. Размеры, которые не являются положительными числами, сообщаются после сохранения и не меняются.

Calculation: как считается цена.

Доступность

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

Maximum weight (kg): скрывает способ, когда корзина тяжелее. По умолчанию: 25. 0 — без ограничения.

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

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

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

Countries (without zones): страны назначения для этого режима из Эстонии, Латвии, Литвы и Финляндии. Поле используется только когда включена Ignore shipping zones. Оставьте пустым, чтобы предлагать способ во всех четырёх странах.

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

Pickup point types: какие пункты SmartPost может выбрать покупатель: Parcel lockers (APT), Parcel boxes (IPB), Parcel shops (PUDO) и Posti post offices (Finland). Оставьте пустым, чтобы предлагать постаматы, боксы и пункты выдачи посылок (по умолчанию). Какие типы существуют, зависит от страны: например, в Латвии есть только посылочные боксы, а отделения почты есть только в Финляндии.

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

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

Debug log: записывает детали расчёта цен и списка пунктов выдачи в WooCommerce > Status > Logs (источник vfd-smartpost). Ошибки, например недоступный список пунктов выдачи, записываются всегда. Данные покупателей не записываются.

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

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

Когда покупатель вводит адрес доставки, WooCommerce запрашивает у плагина тариф. Плагин работает только для Эстонии, Латвии, Литвы и Финляндии. Он проверяет вес корзины, минимальную сумму корзины и исключённые классы доставки, находит коробку для посылки и берёт её цену из строки страны доставки. Если у коробки нет цены или посылка не помещается ни в одну коробку, способ скрывается. Если в стране нет пунктов выдачи (список не удалось загрузить и сохранённой копии нет), способ тоже скрывается, чтобы покупатель никогда не видел оформление заказа, которое нельзя завершить. Если сумма корзины достигает Free from страны, цена равна 0.

Список пунктов выдачи каждой страны кэшируется на 24 часа, и хранится копия последнего удачного списка. Неудачная загрузка запоминается на 15 минут, чтобы оформление заказа не ждало список при каждом обновлении. Время ожидания загрузки — 15 секунд. Разные написания одного города (например, Riga и Rīga) показываются как один город.

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

Плагин не запрашивает тарифы SmartPost, не создаёт отправления, не печатает этикетки, не вызывает курьера и не отслеживает посылки. Создавайте отправления в бизнес-аккаунте SmartPost (SmartPosti). Курьерская доставка до двери не входит в этот способ, и режима карты нет.

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

Когда покупатель выбирает SmartPost, под способом доставки появляются два списка: -- Select city -- и -- Select pickup point --. Списки всегда относятся к стране доставки. В классическом оформлении это страна адреса доставки, а если заказ не отправляется на другой адрес — страна адреса выставления счёта; списки перестраиваются при смене страны. В блочном оформлении списки следуют за страной адреса доставки. Город из адреса доставки выбирается автоматически, если он совпадает с городом в списке. Каждый пункт показывается с названием и адресом. Выбор запоминается во время оформления заказа, поэтому он не теряется при обновлении страницы оформления.

Пункт выдачи обязателен. В классическом оформлении покупатель видит Please select a SmartPost pickup point in the shipping country. В блочном оформлении кнопка Place order заблокирована, пока не выбран пункт. В обоих вариантах сервер повторно проверяет пункт по списку страны доставки, поэтому подделанный или устаревший ID пункта, либо пункт другой страны, отклоняется. Если список страны временно недоступен, покупатель видит сообщение и может выбрать другой способ доставки.

ID, название, город и страна пункта сохраняются в заказе. Они показываются на экране заказа под адресом доставки (с ID места), на странице «Заказ получен», в My account > Orders и в письмах о заказе (HTML и простой текст) как SmartPost pickup point.

Чтобы изменить пункт заказа, откройте заказ и нажмите Change рядом с SmartPost pickup point. Выберите город и пункт в стране доставки заказа. Новый пункт сохраняется сразу, а заметка к заказу фиксирует старый и новый пункт.

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

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

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

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

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

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

SmartPost не появляется при оформлении заказа: проверьте, что лицензия активна, включён Enable/Disable, страна доставки — Эстония, Латвия, Литва или Финляндия, и способ добавлен в зону страны покупателя (или включён Ignore shipping zones и страна разрешена). Откройте страницу настроек: уведомление объяснит, если цена не задана, если у страны нет тарифов или если у страны нет пунктов выдачи. Проверьте также ограничения по весу, Minimum cart total, Excluded shipping classes и размеры коробок: посылка, которая не помещается ни в одну коробку, или коробка с пустой ценовой ячейкой скрывают способ. Если включён Debug log, в WooCommerce > Status > Logs (источник vfd-smartpost) видно, почему способ был скрыт.

Покупатель видит пункты другой страны: списки следуют за адресом доставки. Проверьте, какая страна указана в адресе доставки (или в адресе выставления счёта, если заказ не отправляется на другой адрес). Пункт другой страны отклоняется при оформлении заказа.

Нет пунктов выдачи для страны: список SmartPost не удалось загрузить, и сохранённой копии нет. Плагин повторяет попытку каждые 15 минут. Позже нажмите Refresh pickup point lists now. Также проверьте, что в Pickup point types есть тип, который существует в этой стране.

Список пунктов выдачи устарел: нажмите Refresh pickup point lists now на странице настроек. Списки также загружаются заново каждые 24 часа.

Покупатель не может оформить заказ: нужно выбрать пункт выдачи страны доставки. Если покупатель видит «The SmartPost pickup point list is temporarily unavailable», пунктов этой страны сейчас нет.

В какой валюте цены: в валюте вашего магазина. Плагин не конвертирует валюты.

Для разработчиков: фильтр vfd_smpt_places_url меняет URL списка мест для страны (аргументы: URL, код страны), например для зеркала, которое возвращает тот же XML.

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

Удаление

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

SmartPost и SmartPosti — товарные знаки их владельцев. Этот плагин не связан с SmartPost и не одобрен SmartPost.