Сниппеты

mFilter предоставляет набор сниппетов для работы с фильтрацией, навигацией и SEO.

Обзор

Сниппет	Назначение
mFilter	Вывод отфильтрованных результатов
mFilterForm	Рендеринг формы фильтров
mFilterSelected	Отображение выбранных фильтров
mFilterCrumbs	Хлебные крошки с фильтрами
mFilterNav	SEO-навигация по фильтрам
mFilterSitemap	Генерация sitemap для фильтров

Основные сниппеты

mFilter + mFilterForm

Основная связка для фильтрации товаров:

{* Форма фильтров в сайдбаре *}
<aside>
    {'!mFilterForm' | snippet}
</aside>

{* Результаты фильтрации *}
<main>
    {'!mFilter' | snippet : [
        'element' => 'msProducts',
        'paginator' => 'pdoPage',
        'parents' => $_modx->resource.id,
        'limit' => 24
    ]}

    {$_modx->getPlaceholder('page.nav')}
</main>

mFilterSelected

Показывает текущие активные фильтры с возможностью их удаления:

<main>
    {'!mFilterSelected' | snippet}

    {'!mFilter' | snippet : [...]}
</main>

Вспомогательные сниппеты

mFilterCrumbs

Хлебные крошки с поддержкой сегментов фильтров:

{'!mFilterCrumbs' | snippet : [
    'schemaJsonLd' => true
]}

На странице /catalog/color_red/ выведет:

Главная / Каталог / Красный

mFilterNav

SEO-навигация по значениям фильтров:

<nav class="brands">
    <h3>Бренды</h3>
    {'!mFilterNav' | snippet : [
        'filterKeys' => 'vendor_id',
        'showCount' => true,
        'element' => 'msProducts'
    ]}
</nav>

mFilterSitemap

Генерация XML карты сайта для фильтрованных страниц:

{'!mFilterSitemap' | snippet : [
    'priority' => '0.6',
    'changefreq' => 'weekly'
]}

Режимы работы mFilter

Element/Paginator режим (рекомендуемый)

Делегирует получение и рендеринг данных внешним сниппетам:

{'!mFilter' | snippet : [
    'element' => 'msProducts',      {* Сниппет для данных *}
    'paginator' => 'pdoPage',       {* Сниппет для пагинации *}
    'parents' => 5,
    'limit' => 24,
    'tpl' => 'mfilter.row'
]}

Как это работает:

1. mFilter получает все ID товаров через element с returnIds=1
2. Применяет фильтры к этим ID
3. Передаёт отфильтрованные ID в paginator
4. paginator вызывает element для рендеринга

Legacy режим

mFilter сам выполняет запросы и рендеринг через внутренний Filter::apply() (без внешних сниппетов):

{'!mFilter' | snippet : [
    'parents' => 5,
    'limit' => 24,
    'tpl' => 'product.row'
]}

Используется когда не нужен msProducts/pdoResources. Выборка идёт по modResource, так что для MS3-полей (price, vendor_id) понадобится явный tplOuter с правильным шаблоном.

AJAX

Все сниппеты поддерживают AJAX-обновление без перезагрузки страницы.

Автоматический AJAX

По умолчанию включён. Форма отправляется через JavaScript, результаты обновляются динамически.

Отключение AJAX

{'!mFilterForm' | snippet : ['ajax' => 0]}
{'!mFilter' | snippet : ['ajax' => 0]}

Режимы AJAX

Режим	Описание
form	Отправка по нажатию кнопки
instant	Отправка при изменении любого фильтра

{'!mFilterForm' | snippet : ['ajaxMode' => 'instant']}

Полный пример страницы каталога

{* Хлебные крошки *}
{'!mFilterCrumbs' | snippet : ['schemaJsonLd' => true]}

<div class="catalog">
    <aside class="catalog-sidebar">
        {* Форма фильтров *}
        {'!mFilterForm' | snippet}

        {* SEO-навигация по брендам *}
        <nav class="brands-nav">
            <h4>Популярные бренды</h4>
            {'!mFilterNav' | snippet : [
                'filterKeys' => 'vendor_id',
                'limit' => 10,
                'element' => 'msProducts'
            ]}
        </nav>
    </aside>

    <main class="catalog-content">
        {* Выбранные фильтры *}
        {'!mFilterSelected' | snippet}

        {* Сортировка и вид *}
        <div class="catalog-toolbar">
            <select data-mfilter-sort>
                <option value="pagetitle-asc">По названию</option>
                <option value="price-asc">Сначала дешёвые</option>
                <option value="price-desc">Сначала дорогие</option>
            </select>
        </div>

        {* Результаты *}
        {'!mFilter' | snippet : [
            'element' => 'msProducts',
            'paginator' => 'pdoPage',
            'parents' => $_modx->resource.id,
            'limit' => 24
        ]}

        {* Пагинация *}
        {$_modx->getPlaceholder('page.nav')}
    </main>
</div>