Сниппет BitFacet

Выводит фильтр целиком: форму с группами значений и диапазонами, сортировку, поиск, товары, страницы и «Показать ещё». Вызывать некэшируемым.

[[!BitFacet?
    &set=`auto`
    &limit=`24`
    &tplItem=`myProductCard`
]]
ПараметрПо умолчаниюЧто делает
&setexampleИмя набора. auto — первый набор, в «Разделах» которого есть страница или её предок (набор без разделов подходит любой странице). Список через запятую — выбор из этих наборов.
&parentsтекущая страницаРазделы через запятую, товары которых показывать. По умолчанию — сама страница, если она раздел каталога; иначе весь набор.
&facetsвсеКакие фильтры показывать и в каком порядке: ms:vendor,ms:color.
&rangesвсеКакие диапазоны показывать: ms:price.
&limit12Товаров на странице (до 100).
&categories1Группа «Категории» — дерево разделов ссылками. 0 — не показывать.
&sectionKeysectionИмя фасета-дерева разделов в наборе.
&tplForm … &tplCategorybitfacet.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, простые плейсхолдеры:

Тот же чанк можно написать на Fenom (нужен pdoTools) — например, чтобы показать метку скидки. Такой чанк обрабатывается парсером, поэтому немного медленнее:

{$pagetitle}
{$price}{if $old_price} {$old_price} Скидка{/if}

Картинки товаров: галерея MiniShop3 и Gallery3x

Фильтр сам берёт картинки товаров страницы из установленных галерей — одним запросом на страницу, без сниппетов в карточке. Нужна только таблица галереи на сайте; настраивать ничего не надо.

ПлейсхолдерЧто это
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_namealt картинки (если пуст — название), название.
g3x_countСколько картинок у ресурса в Gallery3x.

Карточка с картинкой из любой галереи — достаточно photo (так сделан чанк примера bitfacet.example.item):

Галерея MiniShop3, картинка под размер экрана:

[[+pagetitle]]

Каталог на обычных ресурсах с Gallery3x (без MiniShop3) — оригинал открывается по клику (data-fancybox — если на сайте подключена библиотека Fancybox):

Если картинки нет, плейсхолдер пустой. Спрятать пустую картинку можно стилями: img[src=""] { display: none; }. Все плейсхолдеры простые — карточка остаётся быстрой и работает в турборежиме. Нужна вся галерея товара (несколько картинок, слайдер) — это уже страница товара: там используйте сниппеты самих галерей (msGallery, Gallery3x).

Работа без перезагрузки (bitfacet.js)

Подключите один скрипт — фильтр начнёт отвечать без перезагрузки страницы:

Что нужно скрипту в своих чанках:

обёртка — обязательно<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=куртка                поиск — всегда параметром

Категории и разделы

Группа «Категории» — дерево каталога ссылками: ветка текущей страницы раскрыта, текущий раздел выделен, у каждого раздела — число товаров с учётом выбранных фильтров. Клик открывает страницу раздела с тем же фильтром: /katalog/odezhda/color-belyj/.

У страниц подразделов должен быть тот же шаблон (со сниппетами BitFacetSeo и BitFacet) — тогда &set=`auto` найдёт набор по предку.

Несколько контекстов и языков

Набор может охватывать несколько контекстов (resources.contexts). Фильтр, ссылки товаров и строки лексикона берутся по контексту страницы, на которой стоит сниппет.