Документация

Внимание!
Данная документация предназначена для клиентов сервиса eShopLogistic, зарегистрированных в старой версии сервиса.
Личный кабинет: eshoplogistic.ru.

Если вы используете новый кабинет по адресу my.eshoplogistic.ru, то перейдите к этому документу:
https://wp-v2.eshoplogistic.ru/documentation-v2/
.

  1. Установка
  2. Настройка
  3. Использование
  4. Кэширование
  5. Частые проблемы

Внимание!
Для корректной работы плагина необходимо учитывать:
1) Убедитесь, что для товаров на сайте указан вес. Без веса расчёт доставки невозможен.
Если нет возможности указать вес для всех товаров на сайте, можно воспользоваться функционалом установки параметров по умолчанию.
2) Плагин не работает с пошаговым оформлением заказа.
3) Также смотрите частые проблемы ниже.


Установка

Для установки плагина eShopLogistic для Woocommerce вам необходимо сделать несколько простых шагов:

  • в админ-панели WordPress перейдите на страницу установки плагинов (Плагины -> Добавить новый), введите в поиске «eshoplogisticru»:
  • нажмите кнопку «Установить».
  • после успешной установки вам будет предложено активировать плагин. Для этого нажмите кнопку «Активировать»:

Отлично! Теперь вы успешно установили и активировали плагин.


Настройка

После активации плагина в главном меню админ-панели появится пункт меню «WC eShopLogistic». Для настройки работы плагина перейдите в этот пункт меню.

API ключ

Для начала вам нужно указать API ключ для сайта, который вы можете найти в своём личном аккаунте в системе eShopLogistic (см. документацию eShopLogistic).



Методы оплаты

Для корректной работы плагина вам также необходимо настроить методы оплаты.

Система eShopLogistic для расчёта стоимости доставки использует четыре типа оплаты:

  • card — банковская карта
  • cash — наличные
  • cashless — безналичный расчёт
  • prepay — предоплата

В настройках вам нужно указать (ассоциировать) какой метод оплаты eShopLogistic соответствует доступным на данный момент методам оплаты Woocommerce. Примечание. При выборе какого-либо метода доставки eShopLogistic, неассоциированные методы оплаты будут недоступны.


Включение виджета в корзине

При включении данного режима в корзине будет работать виджет выбора службы доставки с единой картой ПВЗ. При выключенном режиме — стандартная логика WordPress (все службы по отдельности).
На данном демо-сайте режим виджета в корзине активирован.

Вам нужно указать API ключ виджета, который вы можете найти в своём личном аккаунте в системе eShopLogistic (см. документацию eShopLogistic).


 

Виджет

Для начала вам необходимо настроить виджет в личном кабинете системы eShopLogistic. Как это сделать подробно описано в основной документации.

Плагин WC eShopLogistic создаёт специальный rout (конечную URL точку), который способен принимать данные виджета и создавать заказы Woocommerce.

Конечная URL точка:

Для корректной работы виджета вам необходимо ввести Ключ виджета и Секретный код:

Для добавления кнопки «заказать с расчётом доставки» используйте 2 способа :

Для добавления «встраиваемого виджета расчета доставки в карточке товара»:

Пример добавления:

  1. В код шаблона: открыть в редакторе файл по данному пути и добавить данный шорткод (wp-content/themes/[Название вашей темы]/woocommerce/single-product/add-to-cart/simple.php).
  2. В панели администрирования сайта: открыть админ-панель, открыть товар для редактирования и в визульном редакторе добавить данный шорткод.

Посмотреть виджет в действии вы можете на нашей демо-странице.


Использование

После успешной настройки плагина в разделе Woocommerce => Настройки => Доставка будут доступны методы доставки, которые включены в личном кабинете eShopLogistic.

Добавление метода доставки происходит по стандартной процедуре добавления метода доставки в Woocommerce.

Для начала вам нужно создать Зону доставки, в которой необходимо указать регион доставки — Россия:

Далее вы можете добавить нужные вам методы доставки.
По нажатию на кнопку «Добавить метод доставки» вам будет предложен список всех доступных методов.
Выберите нужный вам:

Вы можете включать и отключать выбранные методы доставки, а также менять порядок их вывода на странице оплаты:

Есть возможность изменения именования метода доставки:

При включении режима корзинного виджета, необходимо добавить один метод доставки с названием «Калькулятор доставки ESL».


Кэширование

Плагин WC eShopLogistic использует стандартное кеширования WordPress для оптимизации скорости работы. В том числе для оптимизации API запросов расчёта стоимости доставки.

Время жизни кэша 1 час.

Если вам необходимо сбросить кэш вручную, то для этого предусмотрен функционал на странице настройки плагина:


Частые проблемы

—  Обязательные поля для работа плагина в корзине: 

  • Страна / регион
  • Населённый пункт или Область / район

— На данные момент, плагин не работает, если для поля (Населенный пункт или Область / район) подключен модуль select2

— Плагин не будет работать корректно, если в настройках (WooCommerce -> доставка) есть два или более одинаковых региона

—  Регионы зоны: Индексы с маской (напр. CB23*) или полностью цифровые диапазоны (напр. 90210...99000) на данный момент не поддерживаются