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, JSON	AJAX API
События msfo:*	События JavaScript
Ошибки 403, payment_link, чанки	FAQ

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

• Менеджеру / интегратору: Быстрый старт → Системные настройки → Интеграция.
• Вёрстальщику: Сниппеты → Подключение на сайте → Чанки.
• Разработчику: AJAX API → События JavaScript → assets/components/msfastorder/js/msfo.min.js.

Возможности

• Модальное окно — 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 Revolution	3.0+
PHP	8.2+
MiniShop3	1.0+
pdoTools	3.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.

Термины

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

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

• Быстрый старт — установка, настройки, вывод на карточке товара, проверка
• Системные настройки — все ключи, MS/MAIL, payment_link, безопасность
• Сниппеты — msFastOrder, msFastOrderClientConfig
• Чанки — кнопка, письма, эталоны формы и success
• Подключение на сайте — жизненный цикл, msfoConfig, поля формы, CSS
• Интеграция и сценарии — шаблон товара, ms3Variants, ЮKassa, метрики
• AJAX API — actions, поля POST, ответы, PHP
• События JavaScript — msfo:*, аналитика
• FAQ — типичные ошибки и диагностика

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

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

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

Лицензия

MIT — core/components/msfastorder/docs/license.txt.