Свои фильтры

Свой фильтр — блок чекбоксов в панели фильтров виджета, которого нет среди характеристик фида: «Акции» с вариантами «Скидка», «Предзаказ», «Лимитированная коллекция». Каждый вариант описывается условиями по каталогу или списком товаров; фид менять не нужно.

Когда нужен свой фильтр

Ситуация	Инструмент
Признак уже есть в фиде характеристикой («Цвет», «Размер»)	Включите характеристику как фильтр в «Настройке выдачи» — свой фильтр не нужен
Признак нужно собрать из нескольких условий: «Скидка» = старая цена выше текущей, «Предзаказ» = свойство, «Лимитированная» = категория	Свой фильтр с тремя вариантами
Нужен бейдж в карточке, а не чекбокс	Метка
Нужен и бейдж, и чекбокс	Метка для бейджа плюс свой фильтр с вариантом «Метки входят в список» для чекбокса

Форма фильтра

Поле	Что это
Название фильтра	Заголовок блока в панели фильтров: «Акции».
Показывать в виджете	Выключенный фильтр продолжает считаться и доступен через API, но в панели фильтров не показывается.
Имя поля в API	Даётся один раз при создании — cf_akcii — и не меняется при переименовании фильтра. По нему собираются подборки на сайте: facetFilters: ["cf_akcii:Скидка"].
Варианты	Один вариант — один чекбокс. У варианта имя («Скидка») и описание товаров: быстрое заполнение «Есть скидка» (старая цена выше текущей, условие менять не нужно) или условия вручную — тем же конструктором, что у правил: свойства, категории, бренд, список товаров, «И / ИЛИ».

Вариант без условий не сохраняется: чекбокс, который ничего не находит, покупателю не нужен. Порядок вариантов в форме — порядок чекбоксов в панели.

Место в панели фильтров

Свой фильтр стоит в общем порядке с полями и характеристиками фида. Кнопка «Порядок фильтров в виджете» над таблицей открывает то же окно, что на странице «Настройка выдачи»: перетащите блоки в нужном порядке.

Когда фильтр появляется

Событие	Когда
Создали новый фильтр	Индекс получает новое поле, товары пересчитываются — обычно несколько минут. До этого фильтра нет ни в виджете, ни в /config.
Изменили варианты	Товары пересчитываются в течение нескольких минут
Обновился фид	Сразу после импорта
Удалили фильтр	Поле уходит из индекса вместе с ближайшим обновлением

Колонка «Товаров» в таблице показывает, сколько товаров попадает хотя бы в один вариант сейчас; прочерк — фильтр ещё не доехал до индекса.

Для разработчика

Свой фильтр в API — обычный фасет своего поля. В /config он приходит в блоке facets с типом «чекбоксы» и подписью-названием (место в панели задаёт порядок элементов массива), а значения поля у товара — имена вариантов, под которые товар попал:

{
  "query": "",
  "facetFilters": [["cf_akcii:Скидка", "cf_akcii:Предзаказ"]],
  "hitsPerPage": 24
}

Вложенный массив — «ИЛИ» между вариантами. Полный разбор и примеры — в «Подборках и витринах через API».