Выводит фильтр целиком: форму с группами значений и диапазонами, сортировку, поиск, товары, страницы и «Показать ещё». Вызывать некэшируемым.
[[!BitFacet?
&set=`auto`
&limit=`24`
&tplItem=`myProductCard`
]]
| Параметр | По умолчанию | Что делает |
|---|---|---|
&set | example | Имя набора. auto — первый набор, в «Разделах» которого есть страница или её предок (набор без разделов подходит любой странице). Список через запятую — выбор из этих наборов. |
&parents | текущая страница | Разделы через запятую, товары которых показывать. По умолчанию — сама страница, если она раздел каталога; иначе весь набор. |
&facets | все | Какие фильтры показывать и в каком порядке: ms:vendor,ms:color. |
&ranges | все | Какие диапазоны показывать: ms:price. |
&limit | 12 | Товаров на странице (до 100). |
&categories | 1 | Группа «Категории» — дерево разделов ссылками. 0 — не показывать. |
§ionKey | section | Имя фасета-дерева разделов в наборе. |
&tplForm … &tplCategory | bitfacet.example.* | Чанки оформления — таблица ниже. |
Скопируйте чанк примера, переименуйте и укажите в параметре. Значения в плейсхолдерах уже экранированы.
| Параметр | Что это | Плейсхолдеры |
|---|---|---|
&tplForm | вся форма | groups, sorts, items, pages, more, total, q (текст поиска), search (1 — поиск включён), action, reset (адрес без фильтров), ms (время расчёта), endpoint, fallback, ctx |
&tplGroup | группа значений | key, caption, values, open (open или пусто), source, field |
&tplValue | значение (галочка) | name, value, label, count, checked, disabled |
&tplRange | диапазон | key, caption, name_from, name_to, from, to, min, max, step, type (number/date), open |
&tplOption | пункт сортировки | value, label, selected |
&tplItem | карточка товара | id, url, pagetitle, longtitle, introtext, uri, photo (картинка для карточки); с MiniShop3 ещё article, price, old_price (пусто, если не больше цены), image, thumb, ms3_*; с Gallery3x — g3x_* (см. «Картинки товаров» ниже) |
&tplPage | ссылка страницы | page, url, current, class (bitfacet-page-first / -last) |
&tplMore | «Показать ещё» | url, page, next (сколько добавится), rest (сколько осталось) |
&tplCategory | ссылка в «Категориях» | url, label, count, level, current, class (bitfacet-category-root / -open / -active) |
[[+имя]] и строками лексикона [[%ключ]] заполняется простой подстановкой — быстро, и его понимает турборежим. Чанк с фильтрами вывода, сниппетами или Fenom обрабатывается парсером (pdoTools, если установлен) — работает, но медленнее; в турборежиме такие запросы выполняет обычный эндпоинт.Чанк myProductCard, простые плейсхолдеры:
[[+pagetitle]]
[[+price]] [[+old_price]]
Арт. [[+article]]
Тот же чанк можно написать на Fenom (нужен pdoTools) — например, чтобы показать метку скидки. Такой чанк обрабатывается парсером, поэтому немного медленнее:
{$pagetitle}
{$price}{if $old_price} {$old_price} Скидка{/if}
Фильтр сам берёт картинки товаров страницы из установленных галерей — одним запросом на страницу, без сниппетов в карточке. Нужна только таблица галереи на сайте; настраивать ничего не надо.
| Плейсхолдер | Что это |
|---|---|
photo | Картинка для карточки из того, что есть: галерея MiniShop3 (размер small, иначе thumb), иначе первая картинка Gallery3x (medium), иначе заглушка MiniShop3 (ms3_product_thumbnail_default). Для обычных ресурсов без галерей — пусто. |
image, thumb | Главная картинка товара MiniShop3 и её превью — поля товара. Товар без картинки — в thumb заглушка MiniShop3. |
ms3_thumb, ms3_small, ms3_medium, ms3_large | Все размеры главной картинки из галереи MiniShop3. Имена — по папкам размеров в настройках источника файлов MiniShop3 (thumbnails): свой размер card — плейсхолдер ms3_card. |
g3x_url | Оригинал первой активной картинки Gallery3x ресурса. |
g3x_small, g3x_medium, g3x_big | Превью Gallery3x — по размерам, которые создаёт Gallery3x (свои размеры — g3x_<имя>). |
g3x_alt, g3x_name | alt картинки (если пуст — название), название. |
g3x_count | Сколько картинок у ресурса в Gallery3x. |
Карточка с картинкой из любой галереи — достаточно photo (так сделан чанк примера bitfacet.example.item):
[[+pagetitle]]
[[+price]] [[+old_price]]
Галерея MiniShop3, картинка под размер экрана:
![[[+pagetitle]]]([[+ms3_small]])
Каталог на обычных ресурсах с Gallery3x (без MiniShop3) — оригинал открывается по клику (data-fancybox — если на сайте подключена библиотека Fancybox):
[[+pagetitle]]
Фото: [[+g3x_count]]
Если картинки нет, плейсхолдер пустой. Спрятать пустую картинку можно стилями: img[src=""] { display: none; }. Все плейсхолдеры простые — карточка остаётся быстрой и работает в турборежиме. Нужна вся галерея товара (несколько картинок, слайдер) — это уже страница товара: там используйте сниппеты самих галерей (msGallery, Gallery3x).
Подключите один скрипт — фильтр начнёт отвечать без перезагрузки страницы:
.bitfacet-toggle;Что нужно скрипту в своих чанках:
| обёртка — обязательно | <form class="bitfacet" data-endpoint="[[+endpoint]]" data-fallback="[[+fallback]]" data-ctx="[[+ctx]]"> |
| у ссылок страниц и «Сбросить» | data-bitfacet-link |
| у ссылки «Показать ещё» | data-bitfacet-more |
| поиск и сортировка | <input name="search">, <select name="sort"> |
| куда «Показать ещё» дописывает товары и где обновляет страницы | .bitfacet-items, .bitfacet-pages |
Пока идёт запрос, у формы класс bitfacet-loading — им удобно показать загрузку.
При включённых ЧПУ и адресе каталога с «/» на конце фильтр записывается в путь:
/katalog/ каталог
/katalog/brand-nike/ один фильтр
/katalog/color-belyj,sinij/brand-nike/ несколько значений — через запятую
/katalog/price-1000-5000/ диапазон; price-1000- и price--5000 — с одной стороны
/katalog/instock-yes/ да/нет — yes/no
/katalog/color-belyj/sort-price-desc/page-2/ сортировка и страница — в конце
/katalog/brand-nike/?search=куртка поиск — всегда параметром
alias в наборе, значения — латиница из подписей (Белый → belyj), считается при сборке индекса.bitfacet.seo. Настоящий ресурс с таким адресом важнее фильтра; непонятный адрес — обычная 404.?f[ms:color][]=belyj&r[ms:price][from]=1000&sort=price:desc&page=2.Группа «Категории» — дерево каталога ссылками: ветка текущей страницы раскрыта, текущий раздел выделен, у каждого раздела — число товаров с учётом выбранных фильтров. Клик открывает страницу раздела с тем же фильтром: /katalog/odezhda/color-belyj/.
У страниц подразделов должен быть тот же шаблон (со сниппетами BitFacetSeo и BitFacet) — тогда &set=`auto` найдёт набор по предку.
Набор может охватывать несколько контекстов (resources.contexts). Фильтр, ссылки товаров и строки лексикона берутся по контексту страницы, на которой стоит сниппет.