Сниппеты 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	`data`	`data`, `tpl`, `json`, `sql`
msOptions	—	только HTML чанка
msProductOptions	`tpl`	`tpl`, `data`, `array`
msCustomer	`tpl`	`tpl`, `data`
msOrderTotal	`tpl`	`tpl`, `data`

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

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

Числа и `*_formatted`

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

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

Личный кабинет и авторизация покупателя — сниппет 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`

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