Сниппеты MiniShop3

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

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

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

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

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

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

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

Или через стандартный синтаксис 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

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

{'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.