msFastOrder — быстрый заказ для MODX Revolution 3 и MiniShop3

Знакомый сценарий: покупатель уже на карточке товара, цена устраивает, вариант выбран — но чтобы оформить заказ, его ведут через корзину, доставку, оплату и ещё три экрана. Часть аудитории уходит на полпути. Особенно на акциях, лид-товарах и позициях с одним SKU, где лишний шаг — это потерянная заявка.

msFastOrder — дополнение для MODX Revolution 3 и MiniShop3, которое добавляет кнопку «Купить в 1 клик» прямо на странице товара. Модальное окно, короткая форма, заказ в MS3 или письмо менеджеру — без перехода в корзину. После оформления покупатель сразу видит номер заказа, сумму и кнопку оплаты, если способ оплаты MS3 отдаёт payment_link (в том числе ЮKassa через msp3YooKassa).

Один сниппет на шаблоне товара — и у вас отдельный канал конверсии рядом с обычной корзиной, без переписывания checkout.

Что умеет

Быстрый заказ в модалке
По клику — AJAX-загрузка товара, форма с количеством, полями покупателя и строкой «Итого» с пересчётом суммы в браузере. Экран успеха остаётся в том же окне: номер заказа, итог, оплата.

Два режима работы
MS — полноценный заказ в MiniShop3 (товары, статус «Новый», доставка и оплата из настроек). MAIL — только уведомление менеджеру и покупателю по email, без записи в MS3. Удобно для лид-форм и тестовых витрин.

Интеграция с MiniShop3 «как у checkout»
При установке создаются способы оплаты и доставки «Fast Order». Контакты и адрес сохраняются в msOrderAddress — в менеджере MS3 заказ выглядит так же, как после обычного оформления. Поддерживаются ms3Variants: с страницы подхватываются вариант, опции и цена.

Оплата сразу после заказа
Если способ оплаты MS3 возвращает ссылку — она попадает в ответ connector и на экран успеха. Отдельный URL в настройках msFastOrder не нужен: работает штатный payment_link MS3.

Гибкий фронтенд
Модалки: native, Bootstrap 5 или Fancybox. Маска телефона, настраиваемые обязательные поля, CSS-переменные --msfo-*. События JavaScript msfo:order:success, msfo:modal:loaded и др. — для аналитики, A/B-тестов и кастомизации без форка.

Защита и контроль
CSRF-токен, rate limit на order/create, серверная валидация полей и телефона, журнал msfastorder_logs. Плагин msfastorder_web обновляет конфиг и токен при отдаче страницы.

Как подключить за минуту

На шаблоне карточки товара:

[[!msFastOrder]]

Или с явным ID ресурса:

[[!msFastOrder? &id=`[[*id]]`]]

Кастомная кнопка в разметке:

<button type="button"
    data-msfo-trigger
    data-msfo-product-id="[[*id]]">
  Купить в 1 клик
</button>

Количество со страницы товара (подхватится в модалку):

<input type="number"
    class="msfastorder-count-[[*id]]"
    value="1" min="1">

С ms3Variants — форма вариантов на странице и тот же сниппет рядом; variant_id и опции уйдут в заказ автоматически.

Кому особенно зайдёт

• интернет-магазинам на MiniShop3, где нужен второй путь к покупке без ломки корзины;
• акциям и товарам «один клик — один SKU», где корзина избыточна;
• проектам с ЮKassa: оплата сразу после быстрого заказа через payment_link;
• студиям и интеграторам: готовый connector, документация, события msfo:*, чанки писем.

msFastOrder не заменяет полноценный checkout — он дополняет его. Корзина остаётся для сложных сценариев, быстрый заказ забирает импульсные покупки с карточки.

Настройки (namespace msfastorder)

• msfastorder_method — MS или MAIL;
• msfastorder_required_fields — обязательные поля, например receiver,phone или receiver,phone,email;
• msfastorder_payment_id / msfastorder_delivery_id — способы оплаты и доставки MS3 (при установке подставляются «Fast Order»);
• msfastorder_modal_library — native, bootstrap или fancybox;
• msfastorder_phone_mask — маска телефона в форме;
• msfastorder_success_redirect — редирект после успеха (опционально);
• msfastorder_rate_limit_* — лимит запросов к connector.

Стек

• MODX Revolution 3.0+
• PHP 8.2+
• MiniShop3 1.0+
• pdoTools 3.x (рекомендуется)

Опционально: ms3Variants, msp3YooKassa.

Дополнение уже в ModStore. Документация доступна по адресу: msFastOrder

На демо-стенде можно посмотреть вживую: кнопка «Купить в 1 клик» на карточке товара, модалка, заказ в MS3 и сценарий с оплатой.

Если уже ставили на свой MS3 — напишите в комментариях, какой режим используете (MS или MAIL) и что хотели бы видеть в следующих версиях.