msProductOptions

Расширенный сниппет для вывода всех или отфильтрованных опций товара с полной информацией о каждой (метаданные, категории, типы).

Параметры

Параметр	По умолчанию	Описание
product	текущий ресурс	ID товара
tpl	tpl.msProductOptions	Чанк оформления
onlyOptions		Вывести только указанные опции (через запятую)
ignoreOptions		Игнорировать указанные опции
groups		Вывести только опции из указанных групп
ignoreGroups		Игнорировать указанные группы
sortOptions		Порядок сортировки опций (через запятую)
sortGroups		Порядок сортировки групп (через запятую)
sortOptionValues		Порядок сортировки значений
return	tpl	Формат вывода: tpl, data, array

Deprecated параметры

Обратная совместимость

Параметр &input устарел. Используйте &product.

Примеры

Все опции товара

{'msProductOptions' | snippet}

Для конкретного товара

{'msProductOptions' | snippet : [
    'product' => 15
]}

Только определённые опции

{'msProductOptions' | snippet : [
    'onlyOptions' => 'color,size,material,weight'
]}

Исключить опции

{'msProductOptions' | snippet : [
    'ignoreOptions' => 'internal_code,supplier_id'
]}

Только из определённых групп

{'msProductOptions' | snippet : [
    'groups' => 'Основные,Габариты'
]}

С сортировкой групп и опций

{'msProductOptions' | snippet : [
    'sortGroups' => 'Основные,Габариты,Дополнительные',
    'sortOptions' => 'weight,dimensions,material,color'
]}

Возврат данных для обработки

{set $options = 'msProductOptions' | snippet : [
    'return' => 'data'
]}

{foreach $options as $key => $option}
    <div class="option">
        <strong>{$option.caption}:</strong>
        {if $option.value is iterable}
            {$option.value | join : ', '}
        {else}
            {$option.value}
        {/if}
    </div>
{/foreach}

Структура данных

При return=data или return=array возвращается массив с полными метаданными:

[
    'color' => [
        'key' => 'color',
        'caption' => 'Цвет',
        'value' => ['Красный', 'Синий'],
        'category' => 'main',
        'category_name' => 'Основные характеристики',
        'type' => 'combo-options',
        'properties' => [...]
    ],
    'size' => [
        'key' => 'size',
        'caption' => 'Размер',
        'value' => 'M',
        'category' => 'main',
        'category_name' => 'Основные характеристики'
    ],
    'weight' => [
        'key' => 'weight',
        'caption' => 'Вес',
        'value' => '250 г',
        'category' => 'specs',
        'category_name' => 'Характеристики'
    ]
]

Плейсхолдеры в чанке

• {$options} — Массив опций товара

Для каждой опции:

• {$option.key} — Ключ опции
• {$option.caption} — Название опции
• {$option.value} — Значение (может быть массивом)
• {$option.category} — ID группы опций
• {$option.category_name} — Название группы

Пример чанка

{* tpl.msProductOptions *}
{if $options?}
    <table class="product-options">
        <tbody>
            {foreach $options as $option}
                <tr>
                    <th>{$option.caption}</th>
                    <td>
                        {if $option.value is iterable}
                            {$option.value | join : ', '}
                        {else}
                            {$option.value}
                        {/if}
                    </td>
                </tr>
            {/foreach}
        </tbody>
    </table>
{/if}

Группировка по категориям

{* tpl.msProductOptions.grouped *}
{if $options?}
    {set $grouped = []}

    {* Группируем опции по категориям *}
    {foreach $options as $option}
        {set $cat = $option.category_name ?: 'Основные'}
        {set $grouped[$cat][] = $option}
    {/foreach}

    {* Выводим сгруппированные опции *}
    {foreach $grouped as $groupName => $groupOptions}
        <div class="options-group">
            <h4>{$groupName}</h4>
            <table>
                {foreach $groupOptions as $option}
                    <tr>
                        <th>{$option.caption}</th>
                        <td>
                            {if $option.value is iterable}
                                {$option.value | join : ', '}
                            {else}
                                {$option.value}
                            {/if}
                        </td>
                    </tr>
                {/foreach}
            </table>
        </div>
    {/foreach}
{/if}

Выбор опций при добавлении в корзину

Если опции можно выбирать (например, цвет и размер):

<form class="product-form">
    {set $options = 'msProductOptions' | snippet : [
        'return' => 'data',
        'onlyOptions' => 'color,size'
    ]}

    {foreach $options as $option}
        <div class="form-group">
            <label>{$option.caption}</label>
            <select name="options[{$option.key}]" required>
                <option value="">Выберите {$option.caption | lower}</option>
                {if $option.value is iterable}
                    {foreach $option.value as $val}
                        <option value="{$val}">{$val}</option>
                    {/foreach}
                {/if}
            </select>
        </div>
    {/foreach}

    <button type="button"
            data-ms-action="cart/add"
            data-id="{$_modx->resource.id}">
        В корзину
    </button>
</form>

Когда использовать

✅ Подходит	❌ Не подходит
Нужны ВСЕ опции товара	Нужны только 2-3 конкретные опции
Требуются метаданные	Важна максимальная скорость
Нужна фильтрация по группам	Простой фиксированный список
Требуется гибкая сортировка
Опции формируются динамически

Для простого вывода конкретных опций без метаданных используйте msOptions.