Сниппеты MiniShop3

MiniShop3 предоставляет набор сниппетов для построения интернет-магазина на фронтенде. Все сниппеты работают через pdoTools и поддерживают шаблонизатор Fenom.

Обзор сниппетов

Сниппет	Назначение
msProducts	Вывод списка товаров с фильтрацией и сортировкой
msCart	Отображение корзины покупок
msOrder	Форма оформления заказа
msGetOrder	Получение информации о заказе
msGallery	Галерея изображений товара
msOptions	Вывод опций для фильтрации товаров
msProductOptions	Характеристики конкретного товара
msCustomer	Личный кабинет покупателя
msOrderTotal	Итоговая сумма заказа

Общие принципы

Вызов сниппетов

Все сниппеты можно вызывать через Fenom:

fenom

{'msProducts' | snippet : [
    'parents' => 5,
    'limit' => 10
]}

Или через стандартный синтаксис MODX:

modx

[[!msProducts?
    &parents=`5`
    &limit=`10`
]]

Кэширование

Сниппеты, работающие с сессией пользователя (msCart, msOrder, msCustomer), должны вызываться некэшированно (с !).

Параметр return

Значения return зависят от сниппета:

Сниппет	По умолчанию	Значения
msProducts	`data`	`data`, `json`, `ids`, `sql`
msCart	`tpl`	`tpl`, `data`
msOrder	`tpl`	`tpl`, `data`
msGetOrder	—	только HTML чанка (параметра `return` нет)
msGallery	`tpl`	`data`, `tpl`, `json`, `sql`
msOptions	—	только HTML чанка
msProductOptions	`tpl`	`tpl`, `data`, `array`
msCustomer	`tpl`	`tpl`, `data`
msOrderTotal	`tpl`	`tpl`, `data`

Default msGallery

После установки свойство return = tpl (чанк). В PHP, если свойство пустое, fallback = data (issue #823). Для массива указывайте return=data явно.

Общие значения:

Значение	Описание
`tpl`	Рендер через чанк
`data`	Массив данных (или HTML строки у msProducts — см. msProducts)
`json`	JSON-строка (msProducts, msGallery)
`ids`	ID через запятую (msProducts)

Числа и `*_formatted`

Плейсхолдеры цен и веса в чанках — числа (float). Для вывода на сайте используйте поля *_formatted.

Сниппет	Поведение
msProducts	`price_formatted`, `old_price_formatted`, `weight_formatted`. Символ валюты — только при `withCurrency => true`. Параметра `formatPrices` нет
msCart, msOrder, msGetOrder, msOrderTotal	`*_formatted` всегда с валютой или единицей веса

У msOrderTotal в свойствах сниппета в админке ещё могут быть formatPrices и withCurrency — код их не читает (issue #825).

Личный кабинет и авторизация покупателя — сниппет msCustomer и страница Авторизация покупателя.

Параметр toPlaceholder

Вместо прямого вывода можно сохранить результат в плейсхолдер:

fenom

{'msProducts' | snippet : [
    'toPlaceholder' => 'products'
]}

{* Позже использовать *}
{$_modx->getPlaceholder('products')}

Чанки по умолчанию

MiniShop3 устанавливает набор готовых чанков:

Сниппет	Чанк по умолчанию
msProducts	`tpl.msProducts.row`
msCart	`tpl.msCart`
msOrder	`tpl.msOrder`
msGetOrder	`tpl.msGetOrder`
msGallery	`tpl.msGallery`
msOptions	`tpl.msOptions`
msProductOptions	`tpl.msProductOptions`
msOrderTotal	`tpl.msOrderTotal`
msCustomer	`tpl.msCustomer.profile` / `.addresses` / `.orders` (по `service`)

Чанки можно переопределить, создав свои версии или указав другой чанк в параметре tpl. Для ЛК см. msCustomer.