Что такое BitFacet

BitFacet — фильтр каталога для MODX 3: галочки, диапазоны «от/до», сортировка, поиск и постраничный вывод товаров со счётчиками у каждого значения. Данные берутся из ресурсов, TV, MiniShop3 (поля товара, опции, производители, дополнительные категории, модификации) и ваших таблиц.

Фильтр не ходит в базу на каждый запрос. Компонент заранее собирает индекс — битовые карты «значение → товары» — и держит его в opcache. Запрос с любым числом отмеченных фильтров считается по индексу за единицы миллисекунд даже на сотнях тысяч товаров. Когда товары меняются, индекс обновляется сам.

Коротко о словах. Набор фильтров — описание фильтра: какие товары, какие фильтры, сортировки, поиск (файл JSON, вкладка «Наборы фильтров»). Индекс — собранные по набору данные. Фасет — фильтр-список значений (бренд, цвет), диапазон — фильтр «от/до» (цена, вес, дата).

Требования

Запуск за 5 минут

  1. Установите пакет. Установщик создаёт набор фильтров example: с MiniShop3 — товары, производитель, цвет, размер, теги, «В наличии», цена, вес; без MiniShop3 — все ресурсы контекста web, раздел и шаблон. Набор виден на вкладке «Наборы фильтров».
  2. Назначьте разделу каталога шаблон bitfacet.example (ресурс → Шаблон). В шаблоне уже есть сниппеты фильтра и SEO, стили и скрипт для работы без перезагрузки. Для своего шаблона — пример ниже.
  3. Откройте раздел на сайте. Если индекса ещё нет, он соберётся при первом открытии (несколько секунд на десятки тысяч товаров). Можно собрать заранее: «Обзор» → «Пересобрать».
  4. Поправьте набор под свой магазин на вкладке «Наборы фильтров» (карандаш у набора): какие товары, какие фильтры и в каком порядке, сортировки, поиск. После сохранения индекс пересобирается сам.
  5. Поставьте крон (вкладка «Индекс» → готовая строка). Он раз в несколько минут проверяет, не пора ли пересобрать индекс, и раз в сутки собирает его целиком. Без крона фильтр тоже работает: индекс обновляется по событиям сайта.

Фильтр в своём шаблоне

Минимум — три строки: SEO-сниппет в начале <head>, фильтр в теле страницы и скрипт перед </body>.


    [[!BitFacetSeo? &set=`auto`]]
    [[!+bitfacet.title:default=`[[*pagetitle]]`]]
    ...


    

[[!+bitfacet.h1:default=`[[*longtitle:default=`[[*pagetitle]]`]]`]]

[[!+bitfacet.text]] [[!BitFacet? &set=`auto` &limit=`24`]]

Проверка