docs.modx.pro
  1. Компоненты
  2. msRussianPost

msRussianPost ​

msRussianPost — дополнение для расчёта стоимости и сроков доставки Почтой России в связке MODX Revolution 3 и MiniShop3. Используются два API: публичный (tariff.pochta.ru) и персональный (otpravka.pochta.ru).

Возможности ​

  • Интеграция с доставками MiniShop3 — класс msrussianpost\Delivery\RussianPostDelivery, привязка виджета к доставке через настройку delivery_id (или авто по классу в БД)
  • Виджет на оформлении заказа — ввод индекса, список методов с ценой и сроком. Показ и скрытие при смене способа доставки (обёртка .msrp__wrapper или [data-msrp-widget])
  • Плагины — msRussianPost Autoload (OnMODXInit) подключает класс доставки, msRussianPost Delivery (msOnGetDeliveryCost) подставляет стоимость выбранного метода, msRussianPost Order tariff (msOnSubmitOrder, msOnBeforeCreateOrder, msOnCreateOrder) сохраняет код тарифа в свойствах заказа для карточки в менеджере MiniShop3
  • Кэш ответов API — настраиваемый TTL, очистка из панели компонента в MODX
  • Админ-панель (Vue 3, PrimeVue 4) — раздел Extras → Почта России: тестовый расчёт, журнал запросов к API, справочник кодов объектов, очистка кэша (нужен VueTools) — см. Админка в MODX
  • Фронтенд — ES-модульный скрипт без jQuery, хуки ms3Hooks, кастомные DOM-события
  • Локализация — лексиконы MODX (ru, en, uk). Для JavaScript сначала подключайте сниппет msrpLexiconScript, затем msRussianPost
  • Кастомизация — Fenom-чанки tplRussianPostStatus, tplRussianPostMethods, BEM-префикс msrp__, CSS-переменные

Системные требования ​

ТребованиеВерсия
MODX Revolution3.0.3+
PHP8.2+
MySQL / MariaDBверсии, совместимые с MODX 3

Зависимости ​

  • MiniShop3 — корзина, заказ, доставки.
  • VueTools — открывает в панели управления MODX раздел Extras → Почта России (тест расчёта, журнал, справочник). Для оформления заказа на сайте VueTools не нужен: виджет расчёта доставки работает без этого пакета.

Установка ​

Кратко: пакет через Extras → Installer, затем создание способа доставки в MiniShop3 и системные настройки. Подробности — в разделе Быстрый старт.

Через ModStore ​

  1. Подключите репозиторий ModStore, если ещё не подключён
  2. Extras → Installer → Download Extras — найдите msRussianPost, установите пакет
  3. Убедитесь, что установлен MiniShop3. Установите VueTools отдельно, если нужен раздел Extras → Почта России в панели управления MODX
  4. Настройки → Очистить кэш

После установки ​

Создайте способ доставки с классом msrussianpost\Delivery\RussianPostDelivery, укажите delivery_id и индекс отправителя, вставьте блок виджета в чанк заказа (лексикон → сниппет → чанки). См. Быстрый старт и Подключение на сайте.

Термины ​

ТерминОписание
Код объектаКод услуги Почты России в API (например 23030 — посылка онлайн, 27030 — EMS RT)
Режим APItariff — публичный калькулятор. otpravka — персональные тарифы по договору
FallbackПри сбое или лимите otpravka расчёт по конкретным кодам добирается через публичный API
ВиджетБлок статуса + список методов на странице оформления заказа