Системные настройки

Все настройки имеют префикс mfilter. и находятся в пространстве имён mfilter.

Полный актуальный список — 22 настройки. Регистрируются автоматически при установке/обновлении пакета.

Пути

Настройка	По умолчанию	Описание
`mfilter.core_path`	`{core_path}components/mfilter/`	Путь к ядру компонента
`mfilter.assets_path`	`{assets_path}components/mfilter/`	Путь к ассетам
`mfilter.assets_url`	`{assets_url}components/mfilter/`	URL ассетов

URL

Настройка	По умолчанию	Описание
`mfilter.url_separator`	`--`	Разделитель ключа и значения в URL (`brand--apple`)
`mfilter.values_separator`	`-or-`	Разделитель множественных значений (`red-or-blue`)
`mfilter.non_canonical_url_handling`	`404`	Что делать с URL без trailing slash и другими не-canonical вариантами: `404`, `301` (редирект на canonical), `off` (не вмешиваться)

Подсказка

До версии 1.3.2 url_separator по умолчанию был _. На обновляющихся установках значение сохраняется прежним — изменение не ломает существующие URL. Новые установки получают --.

Примеры URL

С настройками по умолчанию:

/catalog/brand--apple/color--red-or-blue/price--1000-5000/

С url_separator = _ (legacy) и values_separator = ,:

/catalog/brand_apple/color_red,blue/price_1000-5000/

Фильтрация

Настройка	По умолчанию	Описание
`mfilter.default_limit`	`20`	Количество элементов на странице по умолчанию
`mfilter.default_sort`	`pagetitle`	Поле сортировки по умолчанию
`mfilter.default_sortdir`	`ASC`	Направление сортировки: `ASC` или `DESC`

SEO оптимизация

Настройка	По умолчанию	Описание
`mfilter.seo_noindex_filtered`	`false`	Добавлять `noindex` для всех отфильтрованных страниц
`mfilter.seo_max_filters`	`2`	Максимум активных фильтров, при котором страница индексируется. Если активных фильтров больше — `noindex`
`mfilter.seo_max_values`	`1`	Максимум значений одного фильтра, при котором страница индексируется. `1` = страница `color--red-or-blue` (два значения) получает `noindex`

Логика noindex

seo_noindex_filtered = true     → noindex для любой фильтрации
seo_max_filters = 2             → noindex если активно больше 2 фильтров
seo_max_values = 1              → noindex для страниц с множественным выбором (color--red-or-blue)

Эти три настройки работают совместно — noindex ставится при срабатывании любой.

Кэширование

Настройка	По умолчанию	Описание
`mfilter.cache_enabled`	`true`	Включить кэширование промежуточных результатов фильтрации
`mfilter.cache_lifetime`	`3600`	Время жизни кэша в секундах

Очистка кэша

Кэш автоматически очищается при:

Сохранении ресурса с настроенными фильтрами
Очистке кэша MODX
Изменении набора фильтров в админке

Ручная очистка: mFilter → Обслуживание → Очистить кэш.

Подсказка

С версии 1.4.0 главный механизм ускорения — индекс фасетов, а не кэш. Кэш закрывает повторные запросы к одной и той же выборке.

Словоформы

Настройка	По умолчанию	Описание
`mfilter.morpher_api_key`	``	API-ключ сервиса Morpher для автогенерации словоформ

Morpher API

Для автоматического склонения слов используется Morpher API:

Зарегистрируйтесь на сайте
Получите API-ключ
Укажите его в настройке mfilter.morpher_api_key

Бесплатный лимит — 1000 запросов в день. Без ключа склонения генерируются по упрощённым правилам (русский язык).

Слаги

Настройка	По умолчанию	Описание
`mfilter.slugs_auto_generate`	`true`	Автоматически генерировать слаги для новых значений фильтров

Примеры слагов

Значение	Слаг
Красный	`krasnyj`
Apple iPhone	`apple-iphone`

Транслитерация кириллицы и нормализация выполняются всегда — отдельной настройки нет. Если нужны кастомные слаги — отредактируйте их вручную в mFilter → Слаги.

TV-индекс

Настройка	По умолчанию	Описание
`mfilter.tv_index_on_save`	`true`	Автообновление TV-индекса (`mfl_tv_index`) при сохранении ресурса с TV

Подсказка

Если у вас нет фильтров по TV или массовый импорт затрагивает много ресурсов, отключите эту настройку и пересобирайте индекс вручную через кнопку «Переиндексация» в шапке админки — будет быстрее.

Отладка

Настройка	По умолчанию	Описание
`mfilter.debug_profiler`	`false`	Включить профайлер для отладки производительности

При включении профайлера в ответ AJAX добавляется секция profiler:

json

{
  "success": true,
  "data": { ... },
  "profiler": {
    "total_time": 0.045,
    "queries": 12,
    "memory": "2.5 MB"
  }
}

Фронтенд

Настройка	По умолчанию	Описание
`mfilter.register_frontend`	`true`	Автоматически подключать CSS/JS на фронтенде
`mfilter.auto_submit`	`true`	Автоматическая отправка формы при изменении фильтров
`mfilter.auto_submit_delay`	`300`	Задержка автоотправки (мс)
`mfilter.frontend_assets`	(см. ниже)	JSON-массив CSS/JS файлов для подключения

Список фронтенд-ассетов

mfilter.frontend_assets — JSON-массив путей с плейсхолдерами [[+cssUrl]] и [[+jsUrl]]. По умолчанию:

json

[
    "[[+cssUrl]]web/mfilter.css",
    "[[+jsUrl]]web/core/ApiClient.js",
    "[[+jsUrl]]web/core/FilterAPI.js",
    "[[+jsUrl]]web/modules/hooks.js",
    "[[+jsUrl]]web/mfilter.headless.js",
    "[[+jsUrl]]web/ui/FilterUI.js",
    "[[+jsUrl]]web/ui/SelectedFilters.js",
    "[[+jsUrl]]web/mfilter.slider.js",
    "[[+jsUrl]]web/mfilter.js"
]

При обновлении пакета список обновляется автоматически, только если в нём нет сторонних файлов. Если вы добавляли свои файлы — резолвер их обнаружит и оставит ваш список без изменений (с предупреждением в лог MODX). В этом случае обновляйте frontend_assets вручную или подключайте кастомные скрипты в шаблоне/плагине.

Отключение автоподключения

Если нужно подключить скрипты вручную:

Установите mfilter.register_frontend = false
Подключите нужные файлы в шаблоне:

html

<link rel="stylesheet" href="/assets/components/mfilter/css/web/mfilter.css">
<script src="/assets/components/mfilter/js/web/mfilter.headless.js"></script>
<script src="/assets/components/mfilter/js/web/ui/FilterUI.js"></script>
<script src="/assets/components/mfilter/js/web/mfilter.js"></script>

Пример конфигурации

Минимальная SEO-конфигурация

mfilter.seo_max_filters = 2
mfilter.seo_max_values = 1
mfilter.non_canonical_url_handling = 404

Высоконагруженный сайт

mfilter.cache_enabled = true
mfilter.cache_lifetime = 7200
mfilter.default_limit = 24

Главное условие производительности — собранный индекс фасетов, не настройки кэша.

Без автоподключения JS (свой стек)

mfilter.register_frontend = false
mfilter.auto_submit = true
mfilter.auto_submit_delay = 500

Что изменилось в системных настройках

С версии 1.4.0

(нет новых настроек — индекс фасетов работает прозрачно)

С версии 1.3.2

Добавлено: mfilter.non_canonical_url_handling
Изменён дефолт mfilter.url_separator: _ → -- (только для новых установок)

С версии 1.1.0

Префикс настроек переименован: mfl_* → mfilter.*

handyShop

Утилиты

Настройки

Утилиты

События

Backend API