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

Быстрый старт ​

Как за 10–15 минут включить кнопку «Купить в 1 клик» на странице товара MiniShop3.

Требования ​

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

Шаг 1: Установка пакета ​

Через ModStore ​

  1. Подключите репозиторий ModStore в настройках MODX.
  2. Перейдите в Extras → Installer и нажмите Download Extras (в MODX 3: Пакеты → Установщик).
  3. Убедитесь, что на сайте уже установлен MiniShop3 (и при необходимости pdoTools 3.x для примеров Fenom в этой документации).
  4. Найдите msFastOrder в списке пакетов, нажмите Download, затем Install и дождитесь завершения резолверов (таблица логов, настройки, чанки, сниппеты, плагин).
  5. Настройки → Очистить кэш.

Пакет в каталоге: msFastOrder на modstore.pro.

После установки проверьте ​

ЭлементОжидание
Сниппет msFastOrderВ списке элементов
Сниппет msFastOrderClientConfigВ списке элементов
Чанки msfo_*Установлены
Плагин msfastorder_webВключён (события OnLoadWebPageCache, OnWebPagePrerender)
Таблица msfastorder_logsСоздана в БД

Шаг 2: Системные настройки ​

Настройки → Системные настройки, фильтр по пространству имён msfastorder (или область msfastorder / msfastorder_main в зависимости от сборки транспорта).

Минимум для режима MS (заказ в магазине):

КлючЧто указать
msfastorder_methodMS
msfastorder_payment_idЧисловой ID активного способа оплаты в MiniShop3
msfastorder_delivery_idID способа доставки MS3
msfastorder_email_managerEmail для уведомлений (опционально для MS, обязателен для MAIL)

Для MAIL (только письмо, без заказа в MS3): msfastorder_method = MAIL и непустой msfastorder_email_manager.

Резолвер установки может создать способы Fast Order Payment / Fast Order Delivery и записать их ID в msfastorder_payment_id и msfastorder_delivery_id — проверьте в MiniShop3 → Способы оплаты / доставки.

Подробная таблица всех ключей: Системные настройки.

Шаг 3: Страница «Спасибо» (режим MS) ​

Для способа оплаты без внешнего провайдера (DefaultPayment) в payment_link подставляется страница просмотра заказа с msorder={uuid}.

  1. Создайте ресурс «Спасибо за заказ» (alias, например spasibo-zakaz).
  2. В контент или шаблон добавьте сниппет просмотра заказа MS3, например [[!ms3_get_order]] (по документации вашей сборки MS3).
  3. Укажите ID ресурса в настройке MiniShop3 ms3_order_success_page_id (или аналог в вашей версии MS3).

Шаг 4: Сниппет на карточке товара ​

Откройте шаблон или чанк страницы товара (msProduct). Вызов должен быть некэшированным — иначе CSRF и скрипты могут не обновиться.

fenom
{'!msFastOrder' | snippet}
modx
[[!msFastOrder]]

С явным ID товара (каталог, список в mFilter и т.д.):

fenom
{'!msFastOrder' | snippet : ['id' => $id]}
modx
[[!msFastOrder? &id=`[[+id]]`]]

Параметры сниппета: Сниппет msFastOrder.

Шаг 5: Рекомендуемая разметка (варианты и количество) ​

Если на сайте есть ms3Variants, оберните селекторы вариантов и поле количества в одну форму с классом ms3variants-product-{id} — msFastOrder при открытии модалки скопирует количество и variant_id со страницы.

fenom
{set $productId = $_modx->resource.id}

<form class="ms3variants-product-{$productId} ms3_form" method="post" data-product-id="{$productId}">
  {'!msProductVariants' | snippet : ['product' => $productId]}

  {* msFastOrder читает name="variant_id" или name="ms3variant_id" *}
  <input type="hidden" name="variant_id" value="">

  <input type="number" name="count" class="msfastorder-count-{$productId}" value="1" min="1">
</form>

{'!msFastOrder' | snippet}
modx
<form class="ms3variants-product-[[*id]] ms3_form" method="post" data-product-id="[[*id]]">
  [[!msProductVariants]]
  <input type="hidden" name="variant_id" value="">
  <input type="number" name="count" class="msfastorder-count-[[*id]]" value="1" min="1">
</form>
[[!msFastOrder]]

ms3Variants по умолчанию пишет выбранный вариант в input[name="_variant_id"]. Если в шаблоне остаётся только это поле, при смене варианта копируйте значение в variant_id (событие msfo:modal:beforeLoad или правка чанка ms3_variants) — см. Интеграция → ms3Variants.

На каталоге в цикле товаров задайте класс msfastorder-count-{id} у поля количества:

fenom
<input type="number" name="count" class="msfastorder-count-{$id}" value="1" min="1">
{'!msFastOrder' | snippet : ['id' => $id]}
modx
<input type="number" name="count" class="msfastorder-count-[[+id]]" value="1" min="1">
[[!msFastOrder? &id=`[[+id]]`]]

Иначе может подтянуться чужой input[name="count"] со страницы.

См. Интеграция → ms3Variants.

Шаг 6: Проверка на фронте ​

  1. Откройте страницу товара в браузере (не в режиме предпросмотра с устаревшим кэшем).
  2. В исходном коде страницы должны быть:
    • msfo.min.css и msfo.min.js
    • блок <script>window.msfoConfig = …</script> с csrfToken и connectorUrl
  3. Нажмите кнопку быстрого заказа — откроется модалка с формой.
  4. Заполните ФИО и телефон, отправьте заказ.
  5. Режим MS: заказ в MiniShop3 → Заказы, строка в таблице msfastorder_logs.
  6. Режим MAIL: письмо на msfastorder_email_manager, в MS3 заказа нет.

Проверка connector ​

ПроверкаОжидание
GET …/assets/components/msfastorder/connector.phpHTTP 405 (разрешён только POST)
POST без csrf_tokenHTTP 403, JSON success: false

Шаг 7: Оплата через ЮKassa (опционально) ​

Если нужна ссылка на оплату ЮKassa в ответе и на экране успеха:

  1. Установите msp3YooKassa.
  2. Настройте Shop ID, Secret Key и webhook.
  3. В MS3 включите способ «Оплата через ЮKassa», возьмите его ID.
  4. Пропишите ID в msfastorder_payment_id, msfastorder_method = MS.

Пошагово: Интеграция → ЮKassa.

Что подключается на странице ​

ФайлНазначение
{msfastorder_assets_url}css/msfo.min.cssСтили модалки и формы
{msfastorder_assets_url}js/msfo.min.jsМодалка, AJAX, события
inline window.msfoConfigCSRF, лексикон, URL connector (обновляет плагин msfastorder_web)

Что дальше ​