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

🚫
Не поддерживается работа на страницах, созданных через плагин ContentBlock
⚖️
Убедитесь, что у товаров указан вес Если нет возможности указать вес для всех товаров, воспользуйтесь функционалом параметров по умолчанию.
📋
В корзине должны присутствовать обязательные поля «Страна / регион» и «Населённый пункт или Область / район».
⛔
Плагин не будет работать при следующих условиях: — пошаговое оформление заказа;
— для поля «Населённый пункт» подключён модуль select2;
— в настройках доставки есть два и более одинаковых региона;
— используются индексы с масками (CB23*) или цифровые диапазоны (90210...99000).
🛡️
Обязательно настройте резервный метод доставки Например «Подберёт наш менеджер» — на случай если плагин не вернёт ни одного варианта (нулевой баланс, сетевая ошибка и т.п.).
👤
Требуется аккаунт eShopLogistic Зарегистрируйтесь на eshoplogistic.ru, чтобы получить API-ключ.

Установка

ℹ️
Поддерживаются оба режима WooCommerce Классический (шорткод [woocommerce_checkout]) и блочный (Block Checkout, с версии 2.1.61) — оба работают без дополнительной настройки.

Плагин временно недоступен в маркетплейсе WordPress.org — ожидаем валидации. Установите вручную:

1
Скачайте плагин из архива или с GitHub.
2
Распакуйте архив и загрузите папку в директорию wp-content/plugins через WP File Manager или FTP.
3
В админ-панели перейдите в Плагины → Установленные и нажмите «Активировать» напротив eShopLogistic.
4
В главном меню появится пункт «WC eShopLogistic» — перейдите для настройки.
▶ Как переключиться на классический шорткод в WooCommerce 8.5+
  1. Откройте редактирование страницы оформления заказа.
  2. Выберите блок «Оформление заказа» целиком.
  3. Нажмите «Оформление заказа» в верхней панели инструментов.
  4. Выберите пункт «Классический шорткод».

Либо удалите контент страницы и добавьте шорткод [woocommerce_checkout].

Ввод API ключа Ключ виджета Ключ виджета в WordPress

Блочный режим (WooCommerce Blocks)

Начиная с версии 2.1.61 плагин полностью совместим с блочным оформлением заказа WooCommerce. Никакой дополнительной настройки не требуется — плагин автоматически определяет тип страницы.

📦
Доступный блок
Калькулятор доставки (Оформление заказа)
Добавляет кнопку выбора службы доставки и ПВЗ на страницу оформления заказа. Работает как в классическом, так и в блочном режиме WooCommerce.

Как добавить блок на страницу оформления заказа

✅
Автоматическая интеграция Если на странице используется стандартный блок WooCommerce Checkout, калькулятор доставки встраивается автоматически. Ручное добавление блока не требуется.

Если вы строите страницу оформления заказа вручную:

1
Откройте страницу оформления заказа в редакторе WordPress.
2
Нажмите «+» для добавления нового блока.
3
В строке поиска введите «eShopLogistic» или «Shipping Calculator».
4
Выберите «eShopLogistic Shipping Calculator (Checkout)» и добавьте на страницу.
5
Сохраните страницу — кнопка Опубликовать / Обновить.

Настройка плагина

После активации в главном меню появится пункт «WC eShopLogistic».

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

Основные настройки плагина
Включить / выключить
Глобальный переключатель плагина.
Сбросить кэш
Очищает кэш данных плагина. Используйте, если изменились настройки в кабинете eShopLogistic. Время жизни кэша — 1 час.
Корзинный виджет
Включён — один метод доставки с виджетом выбора службы и ПВЗ. Выключен — каждая служба как отдельный метод доставки.
Стоимость доставки в сумме заказа
При включении стоимость доставки добавляется в итоговую сумму заказа.
Логирование запросов
Записывает запросы и ответы в файл — удобно для отладки.
Путь: https://[ваш_сайт]/wp-content/plugins/eshoplogisticru/esl.log
Новая версия API Обязательно включить
Выключите только если вы зарегистрированы в старой версии eShopLogistic (кабинет dep.eshoplogistic.ru/login).
Единица измерения габаритов
Выберите метрику длины/ширины/высоты товаров. Если габариты не заполнены — пропустите.
API Ключ Обязательно
Ключ доступа из кабинета eShopLogistic.
Ключ корзинного виджета Обязательно
В кабинете eShopLogistic добавьте к ключу виджет типа «Специальный для модулей CMS» и укажите его ключ здесь.
API Ключ Яндекс Карт Необязательно
Активирует строку поиска по адресу на Яндекс Картах. Получите ключ на developer.tech.yandex.ru.

Настройка оплаты

Сопоставьте методы оплаты WooCommerce с вариантами оплат в кабинете eShopLogistic.

Настройка методов оплаты

Виджет в карточку товара

Раздел заполняется, если вы хотите показывать расчёт доставки на страницах товаров. Если виджет в карточке не нужен — пропустите.
Примеры: виджет во всплывающем окне · виджет во вкладке

1
Добавьте виджет в кабинете eShopLogistic и настройте его по документации.
2
Укажите в настройках плагина ключ виджета и секретный код (нужен, если включена отправка заказов из виджета). Данные доступны на вкладке «Подключение на сайте» в настройках виджета.
3
Укажите URL приёма заказов в кабинете eShopLogistic на вкладке «Отправка заказов»:
// Постоянные ссылки (стандартные): https://[ваш_домен]/wp-json/wc-esl/v1/order // Постоянные ссылки (простые): https://[ваш_домен]/?rest_route=/wc-esl/v1/order/
4
Добавьте кнопку вызова виджета в шаблон товара:
// В файле темы (PHP): <?php echo do_shortcode(‘[короткий_код]’); ?>
Пример файла: wp-content/themes/[тема]/woocommerce/single-product/add-to-cart/simple.php
Доступные шорткоды: [shortcode_widget_button_tab] — виджет во вкладке (пример)
[shortcode_widget_button] — виджет во всплывающем окне (пример)
[shortcode_widget_static] — встроенный статический виджет
Настройка отправки заказов из виджета Пример кода виджета

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

Подсказка для выбора города
Текст, который показывается покупателю, если город не указан.
Название кнопки выбора ПВЗ
По умолчанию: «Выбрать способ доставки и пункт самовывоза».
Контролировать способ оплаты
Включите, если настроены корректирующие правила по способу оплаты — при смене оплаты покупатель увидит предупреждение о пересчёте доставки.
Разрешить оформление без выбора доставки
Актуально только при включённом корзинном виджете.
Изменить способ выбора города
Включает всплывающее окно поиска населённого пункта с блокировкой ручного ввода. Рекомендуем включить.
Изображение прелоадера
Замените стандартный прелоадер на собственное изображение.
Поле адреса доставки (Billing / Shipping)
Поле для определения населённого пункта. Рекомендуемое значение — «Town/City».
Отключить скрытие полей адреса при выборе ПВЗ
По умолчанию при выборе ПВЗ плагин скрывает поля «Street address». Включите, чтобы они оставались видимыми.

Планировщик обновления статусов

Включить планировщик
Автоматически запрашивает статусы заказов в транспортных компаниях с заданной периодичностью. При выключении полностью удаляется из WordPress.
Статусы заказов для планировщика
Выберите статусы WooCommerce, по которым будет срабатывать планировщик.
Период обновления (в минутах)
Частота запросов к транспортным компаниям.

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

Укажите данные для создания заявки при выгрузке заказов в службы доставки.

Настройки выгрузки заказов
Код терминала (название службы доставки)
Идентификатор вашего ПВЗ при самостоятельном привозе заказов. Узнайте код у менеджера транспортной компании.
Адрес склада (Регион, Населённый пункт, Улица, Здание, Квартира/офис)
Используется при заборах с вашего склада.
Контакты отправителя (Имя, Телефон, Компания, Email)
Данные отправителя для транспортных компаний.

Настройка соответствия статусов

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

Настройка соответствия статусов

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

В разделе WooCommerce → Настройки → Доставка создайте зону доставки и добавьте методы eShopLogistic.

Создание зоны доставки
1
Создайте зону доставки и укажите регион — Россия.
2
Добавьте метод доставки в зависимости от режима корзинного виджета:
🔴 Виджет ВЫКЛЮЧЕН Выберите нужные службы из кабинета eShopLogistic. Каждая служба — отдельный метод доставки.
🟢 Виджет ВКЛЮЧЁН Выберите один метод — «Калькулятор доставки ESL».
Настройка региона Отдельные методы доставки Настройка метода доставки Метод Калькулятор ESL

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

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

📤Выгрузка заявки на доставку в кабинет службы доставки
📥Получение данных по заявке из службы доставки
🔄Обновление статуса заявки

В интерфейсе выгрузки также можно изменить количество грузомест и их параметры.

Выгрузка заявок Грузоместа при выгрузке

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

Чтобы добавить данные доставки в письмо клиенту, скопируйте шаблон WooCommerce в папку темы и отредактируйте его:

// Оригинал: woocommerce/templates/emails/customer-processing-order.php // Копия в папке темы: [название-темы]/woocommerce/emails/customer-processing-order.php

Вставьте в нужное место шаблона:

Адрес доставки заказа
<?php echo $order->get_shipping_address_1(); ?>
Срок доставки заказа
<?php do_shortcode( ‘[shortcode_email_time_delivery id=’ . $order->get_id() . ‘]’ ); ?>