msBundles

Рендерит HTML комплектов. Ставьте в шаблон товара или туда, где нужны карточки наборов.

Порядок выбора

1. bundle > 0 — один комплект по ID. Если он неактивен и activeOnly=1, результата нет.
2. Иначе product > 0 — комплекты, где товар в составе.
3. Иначе возвращается emptyTpl.

При msbundles_stock_behavior=hide и недоступном остатке по обязательным позициям карточка не выводится. Режимы block и message оставляют карточку с модификаторами --blocked / --warning.

Без картинки у комплекта и при imageFallback=1 берётся thumb первого товара состава.

Параметры

Параметр	По умолчанию	Описание
product	0	ID ресурса товара. Выводит комплекты, куда он входит
bundle	0	ID одного комплекта (вместо product)
tpl	tplMsBundlesItem	Чанк карточки
wrapperTpl	tplMsBundlesList	Обёртка списка
emptyTpl	tplMsBundlesEmpty	Пустой результат
productTpl	tplMsBundlesProduct	Строка состава
imageFallback	0	Нет картинки комплекта → thumb первого товара
activeOnly	1	Только активные
quantity	1	Число комплектов для цены и остатков
toPlaceholder	—	Имя плейсхолдера. Сниппет вернёт пустую строку

Примеры

На странице товара:

fenom

{'!msBundles' | snippet : [
  'product' => $_modx->resource.id,
  'tpl' => 'tplMsBundlesItem',
  'wrapperTpl' => 'tplMsBundlesList',
  'emptyTpl' => 'tplMsBundlesEmpty',
  'activeOnly' => true,
  'quantity' => 1
]}

modx

[[!msBundles?
  &product=`[[*id]]`
  &tpl=`tplMsBundlesItem`
  &wrapperTpl=`tplMsBundlesList`
  &emptyTpl=`tplMsBundlesEmpty`
  &activeOnly=`1`
  &quantity=`1`
]]

Один комплект по ID:

fenom

{'!msBundles' | snippet : [
  'bundle' => 5,
  'tpl' => 'tplMsBundlesItem',
  'wrapperTpl' => 'tplMsBundlesList'
]}

modx

[[!msBundles?
  &bundle=`5`
  &tpl=`tplMsBundlesItem`
  &wrapperTpl=`tplMsBundlesList`
]]

В плейсхолдер:

fenom

{'!msBundles' | snippet : [
  'product' => $_modx->resource.id,
  'toPlaceholder' => 'bundlesHtml'
]}
{$_modx->getPlaceholder('bundlesHtml')}

modx

[[!msBundles?
  &product=`[[*id]]`
  &toPlaceholder=`bundlesHtml`
]]
[[+bundlesHtml]]

Плейсхолдеры карточки и строк состава: Вывод на сайте. Рядом всегда вызывайте msBundles.initialize.