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

Перед началом использования:

  • Убедитесь, что у товаров на сайте указан вес.
    Если нет возможности указать вес для всех товаров на сайте, можно воспользоваться функционалом установки
    параметров по умолчанию.
  • В корзине должны присутствовать обязательные поля: «Страна / регион» и «Населённый пункт или Область / район».
  • Ограничения, при которых плагин не будет работать:
    — пошаговое оформлением заказа;
    — для полей «Населенный пункт» или «Область / район» подключен модуль select2;
    — если в настройках (WooCommerce -> доставка) есть два или более одинаковых региона;
    — не поддерживаются регионы зоны: индексы с маской (напр. CB23*) или полностью цифровые диапазоны (например  90210...99000)
  • ОБЯЗАТЕЛЬНО: настройте резервный метод доставки, например «Подберёт наш менеджер». Это необходимо на тот случай, если вдруг наш модуль по каким-то причинам не отдаст ни одного варианта доставки (нулевой баланс, проблемы где-то в сети или не ответили сервера транспортных компаний).

Установка

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

1. В админ-панели WordPress перейдите на страницу установки плагинов (Плагины -> Добавить новый), введите в поиске «eshoplogisticru»:


2. Нажмите кнопку «Установить».

3. После успешной установки вам будет предложено активировать плагин. Для этого нажмите кнопку «Активировать».

Настройка

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

Основные настройки


  1. Кнопка «Сбросить кэш» позволяет очистить кэш данных плагина.
    Используйте кнопку очистки кэша, если изменились настройки в кабинете eShopLogistic.
    Плагин использует стандартное кеширование WordPress для оптимизации скорости работы; время жизни кэша 1 час.
  2. Переключатель «Включить / выключить корзинный виджет».
    При включении в корзине сайта будет работать виджет выбора службы доставки с единой картой ПВЗ.
    При выключеннии — стандартная логика WordPress (все службы по отдельности).
    На данном демо-сайте режим виджета в корзине активирован.
  3. Переключатель «Включить / выключить логирование запросов»
    При включении все запросы будут записываться в текстовый файл
    Используйте для отладки: влоге фиксируются запросы и ответы сервиса (можно точно видеть состав груза, его вес и габариты).
    Путь к файлу: https://[ваш_сайт]/wp-content/plugins/eshoplogisticru/esl.log
  4. Переключатель «Включить / выключить новую версию api»
    Необходимо включить, если вы зарегистрированы в новой версии eShopLogostic (личный кабинет my.eshoplogistic.ru).
  5. Список «Единица измерения габаритов»
    Если для товаров на сайте указаны габариты, то выберите нужные единицы измерения.
  6. Поле «API Ключ» (обязательно)
    Необходимо указать ключ доступа из кабинета eShopLogistic.
  7. Поле «Ключ корзинного виджета» (обязательно)
    Необходимо указать ключ созданного в Личном кабинете специального виджета для корзины.
  8. Поле «API Ключ для яндекс карты»
    Не обязательно. Необходим для активации поиска по адресу на яндекс картах; упрощает выбор ПВЗ для больших городов.

Варианты оплаты

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


Виджеты

Этот раздер заполняется, если вы хотите использовать виджеты расчёта доставки в карточках товара.
1. Пример виджета во всплывающем окне
2. Пример виджета во вкладке

Настройте нужный виджет в соответствии с документацией на сайте eShopLogistic

Затем укажите соответствующие настройки: ключ виджета и секретный код (он необходим для принятия заказов из виджета).
Эти данные доступны на вкладке «Подключение на сайте» страницы настройки виджета в личном кабинете eShopLogistic.


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

https://[ваш_домен]/wp-json/wc-esl/v2/order

Данный URL необходимо указать в настройках виджета в личном кабинете eShopLogistic: https://eshoplogistic.ru/podkljuchenie/dokumentacija/vidzhety.html, вкладка «Отправка заказов».

*

Добавить кнопку «Заказать с расчётом доставки» можно следующими способами:

  1. В коде шаблона:
    <?php
    echo do_shortcode('[короткий_код]');

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

Для добавления встраиваемого виджета расчета доставки в карточке товара:
do_shortcode('[короткий_код]')

Где «короткий_код» = shortcode_widget_button_tab для вставки виджета во вкладку (пример);

shortcode_widget_button для вставки во всплывающем окне (пример).

shortcode_widget_static для вставки в статическом режиме.

Настройки выгрузки заказов

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


  1. Поля «Код терминала …» указываются, если вы привозите заказы самостоятельно на терминал транспортной компании.
    Код вашего терминала можно узнать у своего менеджера в транспортной компании.
  2. Поля адреса указываются, если грузы забирает курьер транспортной компании.

Настройка статусов

При доставке до получателя груз может проходить через разные статусы.
Чтобы статус заказа WC менялся в зависимости от статуса доставки, необходимо их сопоставить.
Слева указаны стандартные статусы eShopLogistic, справа — статусы заказа WooCommerce.
Перетащите статус WC в нужную ячейку, чтобы сопоставить со статусом eShopLogistic.


Настройка планировщика для обновления статусов

  1. Переключатель «Включить планировщик обновления статусов заказа».
    При включении на сайте будет работать планировщик обновления статусов.
    При выключеннии — полностью удалит планировщик из системы WordPress.
  2. Поле «Статусы заказов для завершения планировщика». Выберите статусы, которые будут завершать работу планировщика.
  3. Поле «Период обновления планировщика (в минутах)». Укажите, через какой интервал будет срабатывать планировщик.

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

Дополнительные настройки

  1. Поле «Описание подсказки для списка городов» используется для показа клиенту, если не указан населённый пункт для доставки.
  2. Опцию «Контролировать способ оплаты» требуется использовать, если у вас настроены корректирующие правила, связанные со способом оплаты. В этом случае при смене способа оплаты после расчёта доставки, пользователь увидим предупреждение о необходимости повторного расчёта.
  3. Опция «Изменить способ выбора города» включает всплывающее окно для удобного поиска населённого пункта. При этом ручной ввод в поле блокируется.
  4. Опция «Изображение для загрузки» позволяет изменить файл прелоадера.

Настройка способов доставки WooCommerce

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

1. Создайте зону доставки и укажите регион доставки — Россия:




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

Если не включена опция «Включить / выключить корзинный виджет» в настрофках плагина, то выберите нужные вам варианты:


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


Если включена опция «Включить / выключить корзинный виджет» в настрофках плагина, нужно выбрать один метод «Калькулятор доставки ESL.

Шаблоны писем

Чтобы переопределить и отредактировать шаблон письма, скопируйте: woocommerce/templates/emails/customer-processing-order.php в папку темы: «НАЗВАНИЕ ВАШЕЙ ТЕМЫ»/woocommerce/emails/customer-processing-order.php

  • В нужном месте данного шаблона добавьте данный код с адресом заказа: $order->get_shipping_address_1();
  • В нужном месте данного шаблона добавьте данный код с сроком доставки заказа:
    <?php do_shortcode( '[shortcode_email_time_delivery id='.$order->get_id().']' ); >
    

Вы можете использовать различные плагины для редактирования шаблонов писем. Данные по адресу доставки хранятся в стандартном методе Woocommerce (get_shipping_address_1() — Адрес, строка 1 (адрес доставки))

Выгрузка заявок на доставку в кабинеты транспортных компаний

После сохранения заказа с расчётом доставки через плагин на странице заказа в WooCommerce появится 3 кнопки (1):


  • Выгрузка заявки на доставку в кабинет транспортной компании
  • Получение данных по заявке
  • Обновление статуса заявки

Для автоматической выгрузки заказов настройте планировщик в параметрах плагина:

Поддержка

Если вы нашли ошибку / недоработку или что-то не получается — напишите запрос в поддержку через личный кабинет eShopLogistic.