msFastOrder

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

Быстрый старт.

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

Установите пакет, задайте настройки и выведите [[!msFastOrder]] на странице товара.

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

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

Требование	Версия
MODX Revolution	3.0+
PHP	8.2+
MiniShop3	1.0+
pdoTools	3.0+ (жёсткая зависимость транспорта)

MiniShop3 даёт товары, заказы, способы оплаты и доставки. pdoTools 3.0+ — требование установщика пакета.

Опционально

• 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 Payment / Fast Order Delivery и прописать их 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 по умолчанию на сервере не собирается)

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

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

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

Лицензия

В транспорте пакета указана GPL v2 (core/components/msfastorder/docs/license.txt). В корне репозитория пакета может лежать MIT (LICENSE, composer.json). Сверяйте лицензию с тем артефактом, из которого ставите дополнение.