docs.modx.pro
msFastOrder
msFastOrder
Быстрый заказ в один клик через модальное окно для MODX 3 и MiniShop3
  • MODX 3
  • PHP 8.2
  • miniShop3
Зависимости
  • miniShop3
  1. Компоненты
  2. msFastOrder

msFastOrder ​

msFastOrder — дополнение для MODX Revolution 3 и MiniShop3: оформление заказа «в один клик» с карточки товара через модальное окно, без перехода в корзину.

С чего начать: Быстрый старт.

Минимальный путь к кнопке на витрине ​

  1. Установить пакет и убедиться, что на сайте работает MiniShop3.
  2. В Системные настройки (область msfastorder) задать msfastorder_method, email менеджера (для MAIL) и ID оплаты/доставки MS3 (для MS).
  3. На шаблоне страницы товара (msProduct) некэшированно вывести [[!msFastOrder]].
  4. Настройки → Очистить кэш и проверить: клик по кнопке → модалка → заказ или письмо.

Детали: Быстрый старт, разметка карточки: Подключение на сайте.

Быстрые ссылки ​

НужноДокумент
Установить и проверить первый заказБыстрый старт
Все ключи msfastorder_* и режимы MS/MAILСистемные настройки
Сниппеты, параметры, кнопка на каталогеСниппеты
msfoConfig, форма в JS, модалкиПодключение на сайте
ms3Variants, ЮKassa, аналитикаИнтеграция
connector.php, actions, JSONAJAX API
События msfo:*События JavaScript
Ошибки 403, payment_link, чанкиFAQ

Кому что читать ​

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

  • Модальное окно — native (по умолчанию), Bootstrap 5 Modal или Fancybox 4/5
  • Режим MS — полноценный заказ в MiniShop3 с одной позицией, покупателем и payment_link
  • Режим MAIL — письмо менеджеру без записи в MS3
  • Количество и итого — поле count, пересчёт суммы в браузере
  • Варианты — подхват variant_id и опций со страницы (ms3Variants)
  • Оплата — ссылка из способа оплаты MS3, в том числе msp3YooKassa
  • Безопасность — CSRF в сессии, rate limit на order/create, журнал msfastorder_logs
  • Расширяемость — DOM-события msfo:* и EventBus msFastOrder.on()

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

ТребованиеВерсия
MODX Revolution3.0+
PHP8.2+
MiniShop31.0+
pdoTools3.0+ (рекомендуется для Fenom)

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

  • MiniShop3 — товары, заказы, способы оплаты и доставки

Опционально ​

  • ms3Variants — выбор варианта на карточке товара
  • msp3YooKassa — онлайн-оплата после быстрого заказа

Установка ​

  1. Подключите репозиторий ModStore.
  2. Extras → Installer → Download Extras — найдите msFastOrder, Download, Install.
  3. Убедитесь, что установлен MiniShop3.
  4. Настройте область msfastorder в системных настройках.
  5. Настройки → Очистить кэш.

Каталог пакета: modstore.pro/packages/integration/msfastorder.

После установки появляются: namespace msfastorder, сниппеты msFastOrder и msFastOrderClientConfig, чанки msfo_*, плагин msfastorder_web, таблица msfastorder_logs. Резолвер может создать способы оплаты и доставки «Fast Order» и прописать их ID в настройки.

Подробнее: Быстрый старт → Шаг 1.

Термины ​

ТерминОписание
connectorassets/components/msfastorder/connector.php — единая точка AJAX (только POST)
msfoConfigwindow.msfoConfig — URL connector, CSRF, маска телефона, лексикон для JS
MS / MAILРежимы: заказ в MiniShop3 или только email
payment_linkURL оплаты из обработчика MS3 (msfastorder_payment_id)
renderFormJS-сборка HTML формы в модалке (чанк msfo_form по умолчанию не рендерится на сервере)

Документация по разделам ​

Архитектура (кратко) ​

Сценарий «клик → заказ» на временной шкале:

Подробнее: Подключение на сайте, AJAX API.

Лицензия ​

GPL v2 — core/components/msfastorder/docs/license.txt.