new

msRussianPost

Расчёт доставки Почтой России для MiniShop3
Документация Демо
Документация Демо
расчет доставки Почта России калькулятор доставки miniShop3 EMS
Ivan Bochkarev
Автор дополнения
Ivan Bochkarev
Пакетов
12
Закачек
79
Обычно отвечает в течение нескольких дней
Автор дополнения
Ivan Bochkarev Ivan Bochkarev
Пакетов
12
Закачек
79
Обычно отвечает в течение нескольких дней

Modx3ProfilerToolbar

тулбар производительности для MODX 3

ms3Pulse

Дашборд продаж и аналитика для MiniShop3: метрики, графики, экспорт

CrawlerDetect

Определение краулеров и защита форм на MODX‑сайте
Версия 1.0.0-pl
Дата выпуска 23.04.2026
Загрузки 0
Просмотры 125
Внимание, этот компонент требует PHP 8.2 или выше!
Внимание, этот компонент требует MODX 3 или выше.
📮 msRussianPost — доставка Почтой России для MODX Revolution 3 и MiniShop3

Расчёт стоимости и сроков по весу заказа и индексу: публичный сервис tariff.pochta.ru и личный кабинет otpravka.pochta.ru со скидками по договору. На оформлении заказа покупатель выбирает тип отправления в виджете. В заказ сохраняются код объекта тарифа и подпись для отображения в админке.

Кому подойдёт
  • нужна Почта России / EMS в MiniShop3 без правок ядра магазина
  • достаточно бесплатного тарифа без ключей или есть доступ к API по договору «Отправка» (токен и ключ)
  • хочется кэшировать ответы API и при отладке смотреть журнал запросов из админки
  • нужно хранить выбранный тариф в свойствах заказа для бэкофиса и отчётов

✨ Возможности
  • Два режима: публичный тариф и персональный otpravka. Если персональный API недоступен, включается резервный расчёт через публичный сервис
  • Плагин msOnGetDeliveryCost меняет цену доставки только у способа с классом msrussianpost\Delivery\RussianPostDelivery
  • Плагин msRussianPost Order tariff подписывается на msOnSubmitOrder, msOnBeforeCreateOrder и msOnCreateOrder
  • Страница в менеджере на Vue 3. Понадобится VueTools: оттуда доступны пробный расчёт, журнал запросов к API, справочник кодов объектов и сброс кэша
  • Интерфейс на RU, EN и UK. Стили виджета с префиксом msrp

🛒 Связка с MiniShop3
  • В настройках задаётся delivery_id, в справочнике доставок — запись с нужным классом обработчика
  • В чанк заказа выводятся сниппеты msRussianPost и msrpLexiconScript плюс чанки статуса и списка методов

📌 На что обратить внимание
  • Для встроенной админки установите VueTools
  • В адресе доставки лучше всегда указывать страну и индекс. Без них расчёт или запись тарифа иногда ведут себя непредсказуемо
  • Подсказки по адресу, например mxDadata, подключаются отдельно. Подробности — в документации на docs.modx.pro

🚀 Быстрый старт
  1. Установите пакет через Extras → Installer
  2. Создайте способ доставки в MS3 с классом msrussianpost\Delivery\RussianPostDelivery
  3. В системных настройках namespace msrussianpost пропишите delivery_id, индекс отправителя и коды объектов (посылка, EMS и т.д.)
  4. В шаблон оформления заказа добавьте блок виджета по примеру из README
  5. Включите плагины msRussianPost Delivery и msRussianPost Order tariff с перечисленными выше событиями

📷 Скриншоты
msRussianPost: виджет способов доставки Почты России на чекауте

msRussianPost: админка в менеджере MODX



msRussianPost: настройки или диагностика



📋 Требования
  • MODX Revolution 3.0+
  • PHP 8.2+
  • MiniShop3
  • VueTools

Документация по компоненту: https://docs.modx.pro/components/msrussianpost/ — установка, настройки, интеграция с чекаутом и mxDadata.



Официальные материалы Почты России: спецификация API «Отправка» — otpravka.pochta.ru/specification. Сайт публичного тарифного калькулятора — tariff.pochta.ru (условия и лимиты запросов смотрите в интерфейсе сервиса и в договоре).

Changelog - msRussianPost

Format: Keep a Changelog Versioning: Semantic Versioning

[1.0.0] - 2026-04-24

Первый публичный релиз компонента msRussianPost для MODX 3 и MiniShop3.

Added

  • Расчёт доставки Почтой России: публичный API tariff.pochta.ru и персональный otpravka.pochta.ru с fallback.
  • Класс доставки msrussianpost\Delivery\RussianPostDelivery, плагины (расчёт стоимости, сохранение выбранного типа отправления в свойства заказа, автозагрузка класса), сниппеты msRussianPost / msrpLexiconScript, чанки tplRussianPostStatus / tplRussianPostMethods.
  • Коннектор (calculate, get_methods, select_method; действия админки: тестовый расчёт, журнал, справочник, кэш), frontend russianpost.js и russianpost.css, страница менеджера на Vue 3 + PrimeVue 4.
  • Системные настройки с префиксом msrussianpost_*, лексиконы ru, en, uk.
  • Интеграция с mxDadata: обработка события mxdadata:order-address-updated для пересчёта тарифа после обновления адреса на чекауте.

Requirements

  • PHP 8.2+, MODX 3.x, MiniShop3; VueTools — для страницы «Почта России» в менеджере.

Последние обсуждения в сообществе MODX.pro