# Фильтр товаров

Фильтр помогает покупателю подобрать товары по характеристикам, цене и наличию. Вы решаете, где он стоит на странице, какие свойства в него попадают, как выглядит каждый пункт и что покупатель увидит в подсказке.

* [Наличие на складах в фильтре](/s/marketpro/doc/nalichie-na-skladah-A1coVEG5PE)
* [Изображения в фильтре товаров](/s/marketpro/doc/izobrazheniya-v-filtre-tovarov-vWlRB8ia3Q)

# Фильтр слева или сверху

Откройте **ASTDESIGN → МаркетПро → Настройки**, вкладка **Каталог**, блок **Списки товаров и разделы**, поле **Вид страницы каталога**:

 ![](https://docs.astdesign.ru/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzLzQ0Yjc4ZmY0LTFiMDYtNDFhOS04MmMyLWYzMjdmNDVhZWIwOS8wYzk2YjNlZC04MDI5LTRmNDktODAyNC1mMDZlMWY3NjM5NGQvaW1hZ2UucG5nIiwidHlwZSI6ImF0dGFjaG1lbnQiLCJpYXQiOjE3OTMyNjI2MDAsImV4cCI6MTc5MzM0OTAwMH0.H7p_VTK_bd0Tq6wlf4EZRm6LGOFEp8DXoteDVfc2I08 " =1339x418")

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

 ![](https://docs.astdesign.ru/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzLzQ0Yjc4ZmY0LTFiMDYtNDFhOS04MmMyLWYzMjdmNDVhZWIwOS9hYTU1ZWFlNS0wY2YwLTRiY2YtYmQ2NS0xMzAxYWI2NGYyNjYvaW1hZ2UucG5nIiwidHlwZSI6ImF0dGFjaG1lbnQiLCJpYXQiOjE3OTMyNjI2MDAsImV4cCI6MTc5MzM0OTAwMH0.H4M0O4jR2ds7EzXGrYxTL9wUHGBGlg793DxaZeHMEP4 " =1549x669")

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

 ![](https://docs.astdesign.ru/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzLzQ0Yjc4ZmY0LTFiMDYtNDFhOS04MmMyLWYzMjdmNDVhZWIwOS82OWU0YmNjYS1iNWMzLTQ0YjQtOTVmZi0yZDNmZDlkMjI5MDYvaW1hZ2UucG5nIiwidHlwZSI6ImF0dGFjaG1lbnQiLCJpYXQiOjE3OTMyNjI2MDAsImV4cCI6MTc5MzM0OTAwMH0.hRdffH1IULhjyqmJg1B9z1UlfHqafi-j2CjMIeRh5TI " =1706x1042")

Настройка действует на весь каталог: отдельному разделу свой вид фильтра задать нельзя.

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

# Какие свойства попадают в фильтр

Состав фильтра задаётся у свойств инфоблока: свойство участвует в фильтре, если для него включён показ в умном фильтре. Это штатная настройка 1С-Битрикс — она описана в [документации 1С-Битрикс](https://dev.1c-bitrix.ru/user_help/settings/settings/smart_filter.php).

Порядок пунктов фильтра идёт по сортировке свойств: у какого свойства значение сортировки меньше, тот пункт выше. Свойства товара и свойства торговых предложений сортируются вместе, одним списком, — поэтому пункт по цвету из торгового предложения может стоять между пунктами основного каталога, если так заданы сортировки.

Значения показываются только те, что реально есть у товаров раздела. Если свойство или значение не появилось в фильтре, проверьте:

* включён ли у свойства показ в умном фильтре;
* заполнено ли свойство хотя бы у одного активного товара раздела;
* не пуст ли фасетный индекс — об этом ниже.

# Как выглядит пункт фильтра

Вид задаётся в настройках свойства, поле **Вид отображения в фильтре**:

**Чекбокс** — список значений с флажками. Вариант по умолчанию.

**Изображения** — вместо флажков картинки: обычно так делают цвет или фактуру. Как подготовить картинки — в статье [«Изображения в фильтре товаров»](/s/marketpro/doc/izobrazheniya-v-filtre-tovarov-vWlRB8ia3Q).

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

 ![](https://docs.astdesign.ru/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzLzQ0Yjc4ZmY0LTFiMDYtNDFhOS04MmMyLWYzMjdmNDVhZWIwOS9jZWEwNTgxOS0zMTA2LTRhYjQtOTAzNC1jMjgzMjY5NWNjODQvaW1hZ2UucG5nIiwidHlwZSI6ImF0dGFjaG1lbnQiLCJpYXQiOjE3OTMyNjI2MDAsImV4cCI6MTc5MzM0OTAwMH0.gUn34yemY8ZXM-tUZCrcDX5FJ66TV1m7jxsC23zQV8Q " =1309x921")

# Свёрнутые и развёрнутые пункты

Каждый пункт фильтра сворачивается и разворачивается кликом по заголовку. Каким покупатель увидит пункт при открытии раздела, задаёт штатная галочка Битрикса **Показать развёрнутым** в настройках свойства для умного фильтра — там же, где включается сам показ в фильтре. Галочка стоит — пункт развёрнут, снята — свёрнут, виден только заголовок.

 ![](https://docs.astdesign.ru/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzLzQ0Yjc4ZmY0LTFiMDYtNDFhOS04MmMyLWYzMjdmNDVhZWIwOS81ZjliMDc3ZS01NTEwLTQxMWYtOGZhYy0wYzQ0NDVjYTRlNGYvaW1hZ2UucG5nIiwidHlwZSI6ImF0dGFjaG1lbnQiLCJpYXQiOjE3OTMyNjI2MDAsImV4cCI6MTc5MzM0OTAwMH0.ziMkpPgpmTkYaCb0U-KQEufXo0hf83ap53prNY9BRS4 " =1493x423")

Всегда развёрнуты:

* **цена**;
* пункт, в котором покупатель уже выбрал значение.

Это действует в фильтре слева, в панели **Все фильтры** фильтра сверху и в мобильной версии. На пункты в строке фильтра сверху галочка не влияет: они и так раскрываются по клику.

# Подсказка у пункта фильтра

Рядом с названием пункта можно показать значок ⓘ с пояснением — например, объяснить, как измерить размер, или показать таблицу соответствия.

Заполните у свойства поле **Подсказка (html)**. В подсказку можно положить не только текст: решение разберёт содержимое и покажет картинки, видео, ролик с YouTube и скрипты, если они там есть.

Если поле **Подсказка (html)** не заполнено, решение возьмёт подсказку из настроек умного фильтра у раздела, а если и там пусто — из подсказки самого свойства.

# Если фильтр не находит товары или работает медленно

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

**Решение:** решение строит и достраивает индекс само, в фоновых задачах — вам нужно только убедиться, что они запускаются. За индекс отвечают две задачи cron:

* **facet** — создаёт индекс, если у инфоблока каталога он помечен как незавершённый;
* **checkFacet** — достраивает индекс по очереди товаров, изменённых после последнего прохода.

Как проверить, что фоновые задачи решения работают, написано в статье [«cron»](/s/marketpro/doc/cron-uknObkicoh).

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

# Индекс не строится после прерванного обмена с 1С

**Симптом:** задачи cron запускаются, товары в каталоге есть, но фильтр не показывает свойства или показывает неполный список товаров — и так часами. Незадолго до этого обмен с 1С оборвался: не хватило времени, упало соединение, остановили вручную.

**Причина:** на время обмена решение ставит паузу на пересоздание индекса — иначе индекс перестраивался бы на каждом шаге загрузки. Пауза — это файл-метка. Обычный обмен снимает её сам, а прерванный оставляет: индекс не будет пересоздаваться, пока метка лежит на месте.

**Решение:** удалите файл-метку. Зайдите на сервер по SSH или через WinSCP под пользователем сайта и откройте каталог:

```
/bitrix/modules/astdesign.marketpro/files/
```

Удалите файл `stopFacet.lock`, если он там есть:

```bash
rm /home/bitrix/www/bitrix/modules/astdesign.marketpro/files/stopFacet.lock
```

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

Второй способ — просто выполнить обмен с 1С до конца: пройдя загрузку товаров, он снимает метку сам.

Рядом в этом же каталоге лежат `facet.lock` и `checkFacets.lock` — они означают «задача уже работает, второй раз не запускать». Их удалять не нужно: решение снимает их само, если задача не завершилась вовремя — через час для `facet.lock` и через полчаса для `checkFacets.lock`.

---

**Documents**

- [Установка решения](https://docs.astdesign.ru/s/marketpro/doc/ustanovka-resheniya-Z8Q6r79liU)
- [FAQ перед покупкой](https://docs.astdesign.ru/s/marketpro/doc/faq-pered-pokupkoj-HPgKP7mWDT)
- [Общая настройка](https://docs.astdesign.ru/s/marketpro/doc/obshaya-nastrojka-Io6HZQaGXf)
- [Шаблон](https://docs.astdesign.ru/s/marketpro/doc/shablon-ylLAFZV3o8)
- [Главная страница](https://docs.astdesign.ru/s/marketpro/doc/glavnaya-stranica-7PwYozaVVo)
- [Магазины (склады)](https://docs.astdesign.ru/s/marketpro/doc/magaziny-sklady-7rEEZJrA45)
- [Каталог](https://docs.astdesign.ru/s/marketpro/doc/katalog-FpnYzZr900)
- [Поиск](https://docs.astdesign.ru/s/marketpro/doc/poisk-xsDdFVh5h0)
- [Текстовые страницы](https://docs.astdesign.ru/s/marketpro/doc/tekstovye-stranicy-jVtNXZv3T5)
- [Реклама и маркетинг](https://docs.astdesign.ru/s/marketpro/doc/reklama-i-marketing-iZkaCoxr5b)
- [Региональность](https://docs.astdesign.ru/s/marketpro/doc/regionalnost-bCuM9AOBNO)
- [Корзина](https://docs.astdesign.ru/s/marketpro/doc/korzina-Mh27pZA7v9)
- [Оформление заказа](https://docs.astdesign.ru/s/marketpro/doc/oformlenie-zakaza-VyvQjOQxZo)
- [Авторизация](https://docs.astdesign.ru/s/marketpro/doc/avtorizaciya-5HwEb1oDJG)
- [SEO и аналитика](https://docs.astdesign.ru/s/marketpro/doc/seo-i-analitika-d1Hw6c4YAM)
- [Уведомления](https://docs.astdesign.ru/s/marketpro/doc/uvedomleniya-SKDyjYg14J)
- [Мобильное приложение](https://docs.astdesign.ru/s/marketpro/doc/mobilnoe-prilozhenie-F5E0hT7TnN)
- [Обновление решения](https://docs.astdesign.ru/s/marketpro/doc/obnovlenie-resheniya-RRRgtxV5uH)
- [Для разработчика](https://docs.astdesign.ru/s/marketpro/doc/dlya-razrabotchika-WJePeJCmpy)
- [Интеграции](https://docs.astdesign.ru/s/marketpro/doc/integracii-D3DqjYOZYm)
- [Что делать, если что-то не работает](https://docs.astdesign.ru/s/marketpro/doc/chto-delat-esli-chto-to-ne-rabotaet-Q8L8sTVJF8)