msOrderCheck

Небольшое дополнение msOrderCheck поможет узнать текущий статус заказа, а также посмотреть историю заказов по данным, имеющимся у покупателя.
Для работы требуется некешированно вызвать сниппет с параметрами.

Параметры сниппета

&fields — Поля, по которым будет проведен поиск заказа(ов) через запятую. Порядок соответствует выводу полей формы. Список доступных полей см. ниже в разделе «Доступные поля». По умолчанию: num,phone
&allRequired — Строго ли проверять совпадение полей в заказе? 1 — да, 2 — нет. Пример: есть два заказа с разными номерами заказа и одинаковыми номерами телефона. Если параметр включен и пользователь ввел только номер телефона для проверки, то ему ничего не будет показано. Иначе он увидит все заказы, соответствующие его номеру телефона. По умолчанию: 1
&showHistory — Показывать историю изменения статуса заказа или нет. По умолчанию: 1
&historySortBy — Поле, по которому осуществляется сортировка истории заказа(ов). По умолчанию: createdon
&historySortDir — Направление сортировки заказа(ов). По умолчанию: ASC
&frontend_css — Css для формы и результатов. По умолчанию: [[+assetsUrl]]css/default.css
$frontend_js — Javascript для отправки и обработки формы. По умолчанию: [[+assetsUrl]]js/default.js
&form — Селектор формы для проверки. Нужен для js и шаблона по умолчанию. По умолчанию: .msOrderCheck
&resultBlock — Селектор блока с результатами. Нужен для js и шаблона по умолчанию. По умолчанию: .msOrderCheckResult
&actionUrl — Адрес коннектора, куда будет отправлена форма. По умолчанию: [[+assetsUrl]]action.php

Шаблоны

&tplForm — Имя чанка для шаблона формы. По умолчанию выводятся поля, указанные в параметре &fields. Имена полей в шаблоне должны соответствовать доступным полям. См. ниже. По умолчанию: tpl.msOrderCheck.form
&tplResult — Имя чанка для оформления одного результата. Доступные плейсхолдеры см. ниже в разделе «Доступные поля». По умолчанию: tpl.msOrderCheck.result
&tplResultWrapper — Имя чанка для обертки результатов. Поддерживает один плейсхолдер [[+output]]. По умолчанию: tpl.msOrderCheck.result.wrapper.
Все шаблоны поддерживают синтаксис MODX и Fenom.

Доступные поля

id — ID записи заказа
user_id — ID пользователя, сделавшего заказ
change_time — Время изменения заказа
createdon — Время и дата создания заказа
num — Номер заказа
email — Email
cost — Стоимость заказа
cart_cost — Стоимость заказа без доставки
delivery_cost — Стоимость доставки
weight — Вес заказа
context — Контекст
comment — Комментарий к заказу
status — Статус заказа
color — Цвет статуса заказа
delivery — Название доставки
payment — Название варианта оплаты
receiver — Покупатель
phone — Номер телефона покупателя
country — Страна
index — Индекс
region — Регион
city — Город
metro — Метро
street — Улица
building — Строение
room — Комната

Примеры использования

Форма с необязательными полями Телефон и Номер заказа. Показать историю заказов и отсортировать по времени изменения:

[[!msOrderCheck? 
    &fields=`phone,num`
    &allRequired=`0`
    &showHistory=`1`
    &historySortBy=`change_time`
    &historySortDir=`ASC`
]]

Результат:

Форма с одним полем — Покупатель. Только текущий статус заказа.

[[!msOrderCheck? 
    &fields=`receiver`
    &showHistory=`0`
]]

Результат: