Страница с настройками модуля выглядит следующим образом:
В настройках есть два параметра:
Страницы с ЧПУ фильтра - шаблоны страниц на которых будет включена обработка и генерация ЧПУ фильтра. В этом параметры следует указать url от корня сайта к тем разделам сайта, в которых фильтр будет работать в режиме ЧПУ (если таких разделов несколько, то следует их перечислить через точку с запятой).
Выберите инфоблоки, для свойств которых будут выводится дополнительные настройки для фильтра - в этом параметре следует указать инфоблоки, для свойств которых будут выводится дополнительные настройки фильтра (чтобы выбрать несколько инфоблоков, выделяйте их с зажатой клавишей Ctrl). Для свойств выбранных инфоблоков форма настроек будет выглядет вот так:
Чтобы открыть окно настроек свойства инфоблока, перейдите в настройки нужного вам инфоблока, откройте вкладку Свойства и кликнете по кнопке рядом с нужным вам свойством.
Описание компонента
Компонент подготавливает фильтр для выборки из инфоблока и выводит форму фильтра для фильтрации элементов. Компонент должен подключаться перед компонентом вывода элементов каталога, иначе список элементов фильтроваться не будет. Компонент содержит четыре шаблона: .default, horizontal, bitronic-vertical, bitronic-horizontal.
В визуальном редакторе компонент расположен по пути Контент > Каталог > Kombox: Умный фильтр.
Указывается один из созданных в системе типов информационных блоков.
Инфоблок
IBLOCK_ID
Для выбранного типа инфоблоков указывается идентификатор информационного блока, элементы которого будут отфильтрованы.
Имя выходящего массива для фильтрации
FILTER_NAME
Задается имя переменной, в которую передается массив параметров из фильтра. Если имя массива не указано, то будет использоваться значение по умолчанию.
ID раздела
SECTION_ID
Указывается ID раздела инфоблока.
Код раздела
SECTION_CODE
Указывается символьный код раздела, из которого будут выбраны элементы. Поле может быть оставлено пустым, если указан ID раздела.
Настройки кеширования
Тип кеширования
CACHE_TYPE
Тип кеширования:
· A - Авто + Управляемое: автоматически обновляет кеш компонентов в течение заданного времени или при изменении данных;
· Y - Кешировать: для кеширования необходимо определить время кеширования;
· N - Не кешировать: кеширования нет в любом случае.
Время кеширования (сек.)
CACHE_TIME
Время кеширования, указанное в секундах.
Учитывать права доступа
CACHE_GROUPS
[Y|N] При отмеченной опции будут учитываться права доступа при кешировании.
Дополнительные настройки
Сохранять установки фильтра в сессии пользователя
SAVE_IN_SESSION
[Y|N] При отмеченной опции установки фильтра будут сохраняться в сессии пользователя.
Имя массива с переменными для построения ссылок в постраничной навигации
PAGER_PARAMS_NAME
Задается имя переменной, в которой передается массив с переменными для построения ссылок компонентом постраничной навигации.
Подключить библиотеку jQuery
INCLUDE_JQUERY
[Y|N] При отмеченной опции компонент будет подключать библиотеку jquery.
Путь к разделу (если фильтр располагается на другой странице)
PAGE_URL
Путь к странице, на которую фильтр будет переходить при фильтрации (нужен если фильтр находится на одной странице, а результат фильтрации необходимо отобразить на другой)
Выводить сообщение с количеством найденных элементов
MESSAGE_ALIGN
Задается с какой стороны выводить сообщение с количеством найденных элементов:
· LEFT - слева;
· RIGHT - справа;
Через сколько секунд скрывать сообщение (0 - не скрывать)
MESSAGE_TIME
Задается интервал в секундах в течении которого будет показываться сообщение с количеством найденных элементов (0 – сообщение не будет скрываться)
Режим самостоятельного определения текущего раздела
Включить
IS_SEF
[Y|N] Включает режим, в котором компонент сам будет определять ID текущего раздела, исходя из заданных шаблонов URL раздела и элемента. В этом режиме компоненту не нужно задавать параметры "ID раздела инфоблока" (SECTION_ID) и "Символьный код раздела инфоблока" (SECTION_CODE). В основном этот режим используется, если вы хотите отображать фильтр на всех страницах сайта, а не только в каталоге. Не путайте его с ЧПУ URL фильтра, который включается в настройках модуля.
Путь к каталогу ЧПУ (относительно корня сайта)
SEF_BASE_URL
Путь к разделу, в котором расположен компонент bitrix:catalog
Шаблон URL, ведущий на страницу с содержимым раздела
SECTION_PAGE_URL
Шаблон URL к разделу, совпадающий с параметром SEF_URL_TEMPLATES[section] компонента bitrix:catalog
Шаблон URL, ведущий на страницу с содержимым элемента раздела
DETAIL_PAGE_URL
Шаблон URL к детальной странице товара, совпадающий с параметром SEF_URL_TEMPLATES[element] компонента bitrix:catalog
Настройки полей
Свойства, которые будут свернуты
CLOSED_PROPERTY_CODE
Указываются свойства инфоблока, которые будут по умолчанию свернуты при показе фильтра. При выборе пункта (не выбрано)-> и без указания кодов свойств в строках ниже, свойства свернуты не будут.
Свойства предложений, которые будут свернуты
CLOSED_OFFERS_PROPERTY_CODE
Указываются свойства предложений, которые будут по умолчанию свернуты при показе фильтра. При выборе пункта (не выбрано)-> и без указания кодов свойств в строках ниже, свойства свернуты не будут.
Сортировать поля фильтра
SORT
[Y|N] Включает сортировку полей фильтра по индексу сортировки
Поля фильтра будут отсортированы по индексу сортировки. Для свойств индексы сортировки можно задать в форме настроек инфоблока, для цен - в настройках цены, для дополнительных полей (Склады, Подразделы и т.д.) в настроках компонента (см. ниже).
Порядок сортировки полей
SORT_ORDER
Указывает направление сортировки полей:
· ASC – по возрастанию;
· DESC – по убыванию;
Показывать поля в фильтре
FIELDS
Указываются поля, которые будут выведены в фильтре. Массив, который может содержать значения:
· SECTIONS - подразделы;
· STORES - склады;
· QUANTITY – количество на складе
· AVAILABLE – наличие на складе
Индекс сортировки поля "Подразделы"
SORT_SECTIONS
Индекс сортировки для поля «Подразделы» - число
Максимальная отображаемая глубина разделов
TOP_DEPTH_LEVEL
Число – указывает максимальную глубину вложенности подразделов для поля «Подразделы», относительно текущего раздела (0 – неограниченная глубина).
Индекс сортировки поля "Склады"
SORT_STORES
Индекс сортировки для поля «Склады» - число
Индекс сортировки поля "Количество"
SORT_QUANTITY
Индекс сортировки для поля «Количество» - число
Индекс сортировки поля "Наличие"
SORT_AVAILABLE
Индекс сортировки для поля «Наличие» - число
Цены
Тип цены
PRICE_CODE
Указывается тип цены для выводимых элементов.
Показывать цены в одной валюте
CONVERT_CURRENCY
При установке флажка цены будут выводиться в одной валюте, даже если в каталоге они будут заданы в разных валютах. При выборе этой опции кеш компонента будет автоматически сбрасываться при изменении курсов валют тех товаров, что показываются компонентом. К примеру, если выбрана конвертация в рубли, а цены в инфоблоке сохранены в евро, то кеш сбросится при изменении курса евро или рубля. Изменения остальных валют на кеш не окажут влияния.
Валюта, в которую будут сконвертированы цены
CURRENCY_ID
Выбор валюты в которой будут отображаться цены.
Складской учет
Не отображать товары, которых нет на складах
HIDE_NOT_AVAILABLE
[Y|N] При отмеченной опции будут скрыты товары, для которых общее количество на складах меньше либо равно нулю, включен количественный учет и не разрешена покупка при отсутствии товара.
Выводить товары со складов
STORES_ID
Указывает те склады, товары с которых будут отображаться и по которым будет осуществляться фильтрация. Чтобы в фильтрации участвовали все склады, оставьте список пустым.
Рекомендуемое значение - все склады.
Этот параметр может увеличить нагрузку на сервер
Поддержка Яндекс Островов (экспорт фильтра в XML)
Включить поддержку Яндекс Островов
XML_EXPORT
[Y|N] При отмеченной опции будет включена поддержка Яндекс Островов.
Заголовок
SECTION_TITLE
Указывается поле, которое будет использоваться в качестве заголовка раздела.
Описание
SECTION_DESCRIPTION
Задается поле, которое будет использоваться в качестве описания раздела.
Предварительно следует настроить отображение необходимых свойств в умном фильтре. Если инфоблок является торговым каталогом, то свойства можно добавить в через радел Магазин административного раздела, заходим в нужный инфоблок и выбираем пункт меню Настройки каталога. На вкладке Свойства элементов следует у нужных свойств отметить галочку Показать в умном фильтре. В результате должно получится например так:
Если необходимо здесь же настраиваем свойства SKU.
Если инфоблок не является торговым каталогом, то чтобы свойство отображалась в фильтре следует отметить галочку Показывать в умном фильтре.
Теперь нам необходимо разместить компонент фильтра (kombox:filter).
На сайте может использоваться комплексный компонент каталога, либо простые компоненты, проверить это очень легко. Переходим в каталог, в любой раздел. Переходим в режим правки, наводим курсор мыши на любой товар и вызываем диалог настроек компонента, кликая по иконке с шестеренкой:
Откроется диалог настроек компонента
В открывшемся диалоге вы сможете увидеть какой компонент используется на странице, если это bitrix:catalog.section или bitrix:catalog.detail, то значит на вашем сайте не используется комплексный компонент каталога, а если bitrix:catalog, то на сайте используется комплексный компонент.
Если на сайте используется комплексный компонент, то про установку читаем здесь, если не используется то здесь.
Комплексный компонент каталога
Сейчас мы рассмотрим установку умного фильтра в каталоге, на примере стандартного интернет-магазина 1С-Битрикс. Так как у нас используется комплексный компонент каталога bitrix:catalog, то нам нужно отредактировать его шаблон (Что делать, если у вас не используется комплексный компонент?). В стандартном демо-магазине используется системный шаблон компонента каталога и чтобы его отредактировать его нужно предварительно скопировать в шаблон сайта. На вашем сайте скорее всего шаблон уже скопирован. Как это проверить? Переходим в любой раздел каталога, в моем случае это будет http://site.ru/catalog/shoes/.
Переходим в режим правки.
Наводим курсор мыши на компонент каталога (любой товар) и в появившейся панели управления выбираем в меню пункт «Редактировать шаблон компонента».
Тут возможны два случая. Если шаблон еще не скопирован, то вы увидите диалог копирования шаблона. В нем необходимо ввести имя нового шаблона и выбрать шаблон сайта. Здесь конечно все на ваше усмотрение, но я рекомендую дать осмысленное название шаблона и выбрать текущий шаблон сайта. Галочки «Применить новый шаблон компонента» и «Перейти к редактированию шаблона» должны быть отмеченными.
Нажимаем «Сохранить» и открывается окно редактирования шаблона.
Вы можете редактировать шаблон в нем, а можете перейти по ссылке Редактировать файл в панели управления и редактировать файл в панели управления, как вам удобно. Если у вас есть доступ к сайта через ftp/sftp то можете редактировать там.
Тут нужно быть внимательным, открыться должен файл шаблона section.php. Если открылся другой файл (например sections.php или element.php), то перейдите по ссылке Редактировать файл в панели управления, в хлебных крошках кликаем по ссылке с названием шаблона, откроется список файлов и в этом списке выбираем файл section.php и открываем его на редактирование как PHP.
В файле section.php находим строчки где вызывается штатный умный фильтр (у меня это строки 80-101):
Если вы не нашли или в вашем шаблоне нет фильтра, что делать?
Если у вас другой шаблон компонента каталога, и вы не нашли, то просмотрите весь файл section.php внимательно, возможно вызов фильтра располагается в другом месте. Если все-таки фильтра вообще нет, то тоже ничего страшного, нам тогда нужно найти вызов компонента bitrix:catalog.section, у меня это строки 161-247, начинаются они так:
Код очень длинный и нам он не интересен, главное что нам нужно знать, что фильтр обязательно должен располагаться до этого компонента, иначе он не будет фильтровать. Поэтому если вы не нашли фильтр, то находим компонент bitrix:catalog.section и где-нибудь выше него (в зависимости от дизайна или ваших предпочтений) вставляем код Kombox-фильтра (см. ниже)
Более подробно прочитать про параметры фильтра можно тут. В стандартном демо-магазине библиотека jquery не поключена, поэтому я указал параметр INCLUDE_JQUERY = Y, чтобы фильтр сам подключил jquery, если на вашем сайте она подключена, то следует указать INCLUDE_JQUERY = N иначе могут быть ошибки. Сохраняем файл и смотрим результат. Должно получиться следующее:
Если вы хотите, чтобы фильтр работал в корне каталога, то нужно отредактировать файл шаблона sections.php. В нем нет фильтра, поэтому добавляем вызов компонента Kombox-фильтр. Но добавить фильтр мало, на этой странице используется компонент bitrix:catalog.top и он не поддерживает фильтрацию, поэтому нам нужно его удалить и на его место вставить компонент bitrix:catalog.section, лучше скопировать код этого компонента из файла section.php с которым мы уже работали.
Есть несколько важных моментов. Так как это корень каталога, то у компонента Kombox-фильтра и bitrix:catalog.section удаляем параметры SECTION_ID и SECTION_CODE, они не нужны. Для компонента bitrix:catalog.section добавляем параметр SHOW_ALL_WO_SECTION = Y, чтобы он выводил товары из всех разделов.
Конечный код файла может сильно отличаться в зависимости от вашего шаблона, дизайна сайта и т.д. Можете скачать мой код для примера. Вот что у меня получилось в итоге:
Каталог на простых компонентах
В этом случае фильтр размещаем аналогично тому как мы это делаем на отдельной странице сайта, т.е. открываем страницу с товарами в визуальном редакторе и размещаем на ней компонент Kombox:Умный фильтр с ЧПУ. Опять же не забываем что компонент фильтра должен располагаться ДО вызова компонента bitrix:catalog.section. Приведу пример вызова компонента фильтра на такой странице:
Как настроить ЧПУ для этого случая можно прочитать здесь.
Я хочу, чтобы фильтр работал только на отдельной странице (например, на главной)
Рассмотрим случай, если вам нужно чтобы фильтр работал на отдельной странице сайта, и при клике по кнопке показать переходил на другую страницу с результатами фильтрации. Например, пусть фильтр будет на главной странице сайта. Для этого просто открываем главную страницу в визуальном редакторе и добавляем компонент Kombox: Умный фильтр и настраиваем его.
В параметрах не нужно указывать параметры ID раздела инфоблока и Символьный код раздела инфоблока, и обязательно нужно указать параметр Путь к разделу, в этом параметре нужно указать путь к странице, на которую будет переходить фильтр. На этой странице должен быть расположен и настроен компонент bitrix:catalog.section. У меня это будет корень каталога /catalog/ (как его сделать и настроить). Сохраняем страницу. На главной странице должен отобразиться фильтр.
Я хочу, чтобы фильтр работал на всех страницах сайта
Если вы хотите, чтобы фильтр работал на всех страницах сайта, а не только в каталоге, тогда компонент фильтра следует размещать в шаблоне сайта и использовать Режим самостоятельного определения текущего раздела.
Для этого открываем файл шаблона header.php. Помним, что фильтр должен вызываться до компонента bitrix:catalog.section, поэтому размещать его следует в header.php, в footer.php он работать не будет.
Я для примера размещу горизонтальный шаблон фильтра сразу после заголовка. Строка файла 187, после кода:
Здесь выставляем любые нужные нам параметры, НО особенно выжны для нас последние 4 параметра. IS_SEF = Y – это мы включаем режим самостоятельного определения текущего раздела. Теперь компонент сам будет определять в каком разделе каталога он находится, но для этого нам так же нужно передать шаблоны url для страниц раздела каталога и детальной страницы. Параметр PAGE_URL следует оставить пустым. В итоге компонент фильтра будет отображаться на всех страницах сайта. Если мы применим фильтр вне каталога, то фильтр перебросит нас в корень каталога (/catalog/) и применит фильтр, если мы применим фильтр находясь в разделе каталога, то фильтр останется на текущей странице, если применим на детальной странице, то фильтр перебросит нас на страницу раздела.
Блок "Ваш выбор"
Блок "Ваш выбор" - это вывод выбранных значений свойств фильтра. Его можно вывести в любом месте, чтобы пользователь видел по каким параметрам отфильтрованы товары и быстро мог отменить какие-то значения. Актуально для фильтров с большим количеством свойств. Данный блок так же работает в режиме ajax.
Вывести этот блок можно в любом месте на странице с фильтром (в шапке, в подвале, в сайдбаре, даже до вывода самого фильтра). Для этого в нужном вам месте разместите код:
Если вы сделали все по инструкции, а фильтр не работает, то вот вам перечень самых частых ошибок.
Не подключен jquery
Для работы фильтра необходима библиотека jquery, если у вас на сайте ее нет, то следует ее подключить в шаблоне сайта, лучше через функцию CJSCore::Init(array("jquery")); либо можете указать параметр компонента фильтра INCLUDE_JQUERY = Y
Подключено два jquery
Бывает так, что в шаблоне сайта подключено две (три, четыре) версии jquery, из-за этого js-код фильтра может не работать и может работать не правильно. Обычно ошибка в таком случае выглядит примерно так (смотрите в консоли Google Chrome):
В этом случае нужно избавится от лишнего подключения jquery. В идеале следует подключать системную jquery вот так:
CJSCore::Init(array("jquery"));
Ошибка javascript
Так же следует убедится что нет других js-ошибок, иногда какая-то ошибка прерывает выполнение javascript.
Не указан параметр FILTER_NAME у компонента catalog.section
У компонента catalog.section обязательно нужно указать параметр FILTER_NAME – имя фильтра (обычно arrFilter), если вы используете комплексный компонент каталога bitrix:catalog, то аналогичный параметр следует указать у него.
На странице оставлен старый умный фильтр
Как ни странно, но очень популярная ошибка. При установке вам обязательно нужно удалить или закомментировать старый умный фильтр (bitrix:catalog.smart.filter), если он есть на странице, вместе они не будут корректно работать.
Комментировать необходимо через php - комментарии:
<?
/*
код
*/
?>
Если вы закомментируете через html-комментарии:
<!--
код
-->
То хоть фильтр и не будет отображаться, он все равно будет вызываться и мешать Kombox-фильтру.
Ошибка Fatal error: Class 'DOMDocument' not found in /home/bitrix/www/bitrix/modules/kombox.filter/include.php на странице редактирования настроек свойства инфоблока.
В этом случае нужно на хостинге установить расширение php dom.so
SEO
Важно!
Чтобы работало SEO-фильтра, все seo-теги должны выводиться штатными функциями:
H1 - $APPLICATION->ShowTitle(true)
Title - $APPLICATION->ShowTitle()
Keywords - $APPLICATION->ShowMeta("keywords", false, true);
Description - $APPLICATION->ShowMeta("description", false, true);
Для того, чтобы задавать значения мета-тегов для страниц фильтра, вам нужно в настройках модуля фильтра выбрать инфоблок(и), для которых вы будете создавать правила.
Для этого в административном разделе переходим в Рабочий стол/Настройки/Настройки продукта/Настройки модулей/Kombox: Умный фильтр
После этого в разделе Маркетинг/Поисковая оптимизация/Kombox SEO-фильтр появятся выбранные инфоблоки и можно будет создавать правила.
Правило - это набор свойств и их значений, которые должны быть заданы в фильтре, чтобы указанные значения мета-тегов были выведены на странице.
Пример правила:
Данное правило будет применяться, если в фильтре будет выбран производитель Samsung. Значение свойства указывать не обязательно, может быть любое значение. Можно указать несколько свойств, в том числе числовые. Например правило может быть таким:
Так же нужно указать раздел инфоблока, к которому будет применяться данное правило, либо это может быть весь инфоблок.
Далее нужно указать значения для мета-тегов.
Можно задавать значения явно,а можно использовать шаблоны для выбранных свойств, которые при отображении будут заменены на выбранные значения.
Т.е. H1 заданный как "Телевизоры #MANUFACTURER#", при выборе производителя Samsung будет выведен как "Телевизоры Samsung".
Отдельно стоит рассказать, про поле "Текст". Здесь можно указать любой произвольный текст, в том числе в html формате, который можно вывести в любом месте страницы. Для этого нужно разместить в нужном месте такой код:
Для фильтрации без перезагрузки страницы существует специальный шаблон фильтра - ajax. Т.е. если вы хотите перейти на ajax, то в настройках компонента фильтра, нужно выбрать этот шаблон.
Но это не все, к сожалению. Вам придется самостоятельно написать код обработчика для обновления списка товаров. Так как у списка товаров на каждом сайте свой дизайн, могут быть "навешаны" различные обработчики событий, ajax-добавление в корзину и т.д., то вам придется самостоятельно все это обновлять, фильтр только даст вам новый html-код страницы. Но если вы знаете javascript, то все это не так уж и сложно, даже на самых "навороченных" сайтах у меня это не занимало больше 1 часа. А для стандартного демо-магазина это вообще всего пара строк кода!
Наш фильтр работает, фильтрует товары, но для этого нам нужно каждый раз нажимать кнопку "Показать", а мы хотим чтобы все было сразу, выбрал свойство - получил результат. И так поехали!
Для начала меняем шаблон компонента фильтра на ajax. Так же, чтобы не отправлять весь html-код страницы будем обрезать его. Для этого в файле шаблона каталога section_vertical.php в верху файла, до подключения компонента фильтра добавляем такой код:
Затем нам нужно написать код обработчика. Код можно разместить в любом удобном месте, главное чтобы он подключался на странице. Я же буду его писать прям в шаблоне каталога, для простоты и наглядности. Так же я буду использовать jquery, хотя в случае демо-магазина это не обязательно, но уверен, для вашего сайта jquery будет нужен, тем более он уже подключен, так как шаблоны фильтра его используют.
Для начала сделаем просто обновление html списка каталога. Размещаем код скрипта в конце файла section_vertical.php, после нашего кода кода с die():
<script>
BX.ready(function(){
BX.addCustomEvent("onKomboxFilterCatalogLoading", BX.delegate(function(data){
var $data = $('<div>' + data + '</div>');
var content = $data.find('.catalog-section[data-entity="container-1"]');
var cur_content = $('.catalog-section[data-entity="container-1"]');
cur_content.replaceWith(content);
//учтем постраничку
var pager = $('div[data-pagination-num]', $data);
var cur_pager = $('div[data-pagination-num]');
if(pager.length){
if(cur_pager.length)
{
cur_pager.replaceWith(pager).show();
}
else
{
content.after(pager);
}
}
else if(cur_pager.length){
cur_pager.hide();
}
}, this));
});
</script>
Пробуем фильтровать, список товаров обновляется через ajax, все хорошо, но сами товары отображаются не корректно, не выделяются при наведении курсора, нельзя добавить в корзину, поменять цвет и т.д. Это то о чем я писал выше, мало просто обновить список товаров, нужно еще учесть нюансы дизайна конкретного сайта.
Теперь нам нужно доработать наш обработчик, чтобы применить все необходимые скрипты. В стандартных шаблонах js-код вызывается сразу в шаблонах, поэтому в данном случае наша задача сильно упрощается, нам всего лишь нужно найти эти скрипты и выполнить их. Теперь наш обработчик будет таким:
<script>
BX.ready(function(){
BX.addCustomEvent("onKomboxFilterCatalogLoading", BX.delegate(function(data){
var $data = $('<div>' + data + '</div>');
var content = $data.find('.catalog-section[data-entity="container-1"]');
var cur_content = $('.catalog-section[data-entity="container-1"]');
cur_content.replaceWith(content);
//учтем постраничку
var pager = $('div[data-pagination-num]', $data);
var cur_pager = $('div[data-pagination-num]');
if(pager.length){
if(cur_pager.length)
{
cur_pager.replaceWith(pager).show();
}
else
{
content.after(pager);
}
}
else if(cur_pager.length){
cur_pager.hide();
}
//выполним скрипты
var ob = BX.processHTML(data);
BX.ajax.processScripts(ob.SCRIPT);
}, this));
});
</script>
И список товаров теперь отображается после фильтрации правильно:
На этом переход на ajax можно считать оконченным!
Если у вас не получается написать обработчик, то я могу написать его вам за дополнительную плату. Пишите мне на support@kombox.ru
Вопрос-ответ
Как разместить фильтр слева (в подвале, шапке и т.д.)?
Что делать если нам нужно разместить фильтр в подвале сайта или слева/справа в сайдбаре? Но при этом фильтр должен вызываться ДО компонента bitrix:catalog.section. Есть замечательный метод CMain::ShowViewContent. Метод позволяет установить выводимый контент для функции AddViewContent. С помощью этого метода можно вывести фильтр где угодно. Допустим мы используем комплексный компонент каталога и фильтр у нас вызывается (или будет вызываться) в файле шаблона section.php (sections.php). Тогда вызов фильтра должен быть таким:
Т.е. перед фильтром мы вызываем метод SetViewTarget, после EndViewTarget. В результате фильтр отработает ДО компонент bitrix:catalog.section, но показан он не будет. Затем в том месте где мы хотим отобразить фильтр необходимо вызвать метод <?$APPLICATION->ShowViewContent('sidebar');?>. Это может быть любым местом – шаблон сайта, шаблон другого компонента, включаемая область.
Подсказки вводятся в настройках свойств инфоблока. Можно вводить в стандартное поле Подсказка (максимальная длина подсказки 200 символов), либая в поле Подсказка (любая длина подсказки) в блоке Дополнительные параметры для Kombox: Умный фильтр.
Как и где менять параметры компонент?
Если фильтр подключен у вас отдельно от комплексного компонента каталога или комплексный компонент у вас вообще не используется, то все стандартно, переходим в режим правки и правим параметры фильтра через диалог параметров:
Если же компонент фильтра подключен у вас в шаблоне комплексного компонента bitrix:catalog, то нельзя будет изменять параметры фильтра через визуальный редактор или диалог параметров компонента. К сожалению, такая особенность архитектуры компонентов в 1С: Битрикс. Вам придется править параметры в коде шаблона (обычно это файлы section.php и sections.php шаблона компонента каталога).
Для этого перейдите в каталог на страницу с фильтром, перейдите в режим редактирования и вызовите диалог редактирования шаблона.
Найдите в коде шаблона вызов компонента Kombox-фильтра и отредактируйте его параметры.
Как включить полноценное ЧПУ?
Полноценное ЧПУ (ссылки фильтра вида /filter/price-from-9629-to-27728/manufacturer-acer-or-asus/) включается в настройках модуля Kombox: Умный фильтр (/bitrix/admin/settings.php?lang=ru&mid=kombox.filter&mid_menu=1)
В поле Страницы с ЧПУ фильтра укажите раздел каталога (обычно это catalog), если таких разделов несколько то перечислите их через точку с запятой.
Если у вас комплексный компонент каталога (bitrix:catalog), то на этом настройка закончена. Если вы не используете комплексный компонент, то вам нужно в файл urlrewrite.php добавить правила обработки адресов. Я бы рекомендовал вам все-таки использовать комплексный компонент каталога, но если это невозможно, то вам придется самостоятельно написать правила обработки адресов, чтобы при переходе по ссылкам вида /filter/price-from-9629-to-27728/manufacturer-acer-or-asus/ открывался каталог и не было 404 ошибки. Я приведу пример таких правил для url вида:
Для этого у свойств нужно задать индекс сортировки.
А у компонента фильтра задать параметрSORT = Y и указать направление сортировки через параметр SORT_ORDER (ASC – по возрастанию индекса сортировки, DESC – по убыванию).
Индексы сортировки для полей фильтра (Подразделы, Склады, Количество, Наличие) задаются в настройках компонента.
Индекс сортировки для цен задается в настройках типа цены (/bitrix/admin/cat_group_admin.php?lang=ru).
Включил ЧПУ, теперь при сортировке фильтр сбивается, как исправить?
ЧПУ работает таким образом, что модуль подменяет текущий url и метод CMain::GetCurPageParam начинает работать не правильно. В итоге если у вас в каталоге какие-то ссылки (например сортировка, вид списка товаров и т.д.) были организованы через этот метод, то теперь при переходе по таким ссылкам, фильтр будет сбрасываться. Чтобы этого избежать, следует использовать аналогичную функцию CKomboxFilter::GetCurPageParam. Пример вызова функции:
Как сделать, чтобы при несуществующих параметрах в url выводилась 404 ошибка?
Если вы хотите чтобы в режиме ЧПУ фильтра, если в url есть лишние/несуществующие/неправильные параметры, то сайт не игнорировал их, а выводил 404 ошибку, то это инструкция для вас.
Дело в том что фильтр не может знать обо всех возможных параметрах, которые могут быть в url, чтобы однозначно определить лишние они или нет. Например в интернет-магазине Битроник сортировка реализована через ЧПУ. У других сайтов могут быть свои особенности. Поэтому фильтр, если встречает неправильные параметры в url он устанавливает константу KOMBOX_FILTER_ERROR_404 = Y. И уже по этой константе вы можете на конкретном сайте принимать решение выводить ошибку 404 или нет, делая если потребуется дополнительные проверки. Начиная с версии 2.5.6 можно получить массив параметров, который фильтр посчитал недействительными. Массив возвращает функция CKomboxFilter::GetUnavailableParams().
Вот пример обычного обработчика без проверок, который в случае если константа KOMBOX_FILTER_ERROR_404 = Y выводит страницу с 404 ошибкой:
Данный код следует поместить в файл /bitrix/php_interface/init.php (если на сайте такого файла нет, то его нужно создать).
Как убрать промежуточные значения в слайдере?
Иногда требуется убрать промежуточные значения в слайдерах, т.е. чтобы выводилось только максимальное и минимальное значение. Для этого поместите в стилях сайта такие правила:
К сожалению нельзя, фильтры будут мешать друг-другу.
Как задать сортировку значений свойства
Для каждого свойства можно задать сортировку значений. Для этого нужно включить вывод дополнительных настроек для фильтра. Зайдите в настройки модуля и выберите нужный инфоблок(и) в списке "Выберите инфоблоки, для свойств которых будут выводится дополнительные настройки для фильтра"
После этого, нужно зайти в настройки свойства инфоблока и задать сортировку:
Как настроить постраничную навигацию?
Если при переходе на другую страницу, параметры фильтра сбрасываются, то вам следует настроить постраничную навигацию.
Для этого заходим в настройки компонента каталога, и идем в блок настроек "Настройки постраничной навигации". Здесь отмечаем галочку "Включить обработку ссылок", параметр "Url для построения ссылок (по умолчанию - автоматически)" оставляем пустым, в параметре "Имя массива с переменными для построения ссылок" задаем значение "arrPager". В конечном итоге должно быть вот так:
После этого следует проконтролировать, что данные параметры передаются компоненту фильтра и компоненту catalog.section (Элементы раздела). Т.е. подключение компонента фильтра, должно выглядеть примерно так:
Если вы не используете комплексный компонент каталога, то данные параметры нужно задавать напрямую у компонентов фильтра и catalog.section (Элементы раздела)
Как менять представление, подсказку, сортировку, количество выводимых значений у свойств?
Дополнительный настройки свойства можно менять в настройках свойства инфоблока. Для этого в настройках модуля фильтра нужный инфоблок должен быть задан в параметре "Выберите инфоблоки, для свойств которых будут выводится дополнительные настройки для фильтра":
Задали инфоблок или несколько инфоблоков. После этого, переходим в настройки инфоблока, на вкладку "Свойства":
Затем, рядом с нужным свойством нажимаем кнопку "Изменить". Открывается диалоговое окно, в котором можно задать представление свойства, подсказку, сортировку и т.д.:
Как задать свои критерии для отбора элементов?
По умолчанию фильтр работает либо со всеми товарами из инфоблока, либо с товарами из какого-то раздела. Иногда нужно фильтровать не по всем товарам, а по каким-то определенным, т.е. нужно задать свои критерии для отбора. Например:
Фильтр товаров на странице поиска
Фильтр товаров какого-то конкретного бренда. Т.е. если на сайте есть страницы брендов и там выводятся все товары этого бренда, то хорошо бы на такой странице сделать фильтр.
На любой странице где есть список товаров, отобранных по какому-то критерию: товары со скидкой, акции, популярные товары и т.д.
Реализуется это очень легко. У компонента фильтра есть параметр FILTER_NAME, в него нужно передать название переменной, обычно это arrFilter, в которую фильтр сохранит сгенерированный массив-фильтр для функции CIBlockElement::GetList. Обычно этот массив передается в компонент bitrix:catalog.section или bitrix:news.list, у которых тоже есть параметр FILTER_NAME. Но если мы перед вызовом компонента фильтра зададим какие-то критерии в переменной arrFilter, то фильтр их учтет, и будет фильтровать товары с учетом этих критерий. В общем случае это будет выглядеть так:
global $arrFilter;
$arrFilter = array(
/*параметры*/
);
/*
например, зададим отбор по строковому свойству с кодом BRAND
$arrFilter = array(
"PROPERTY_BRAND" => "samsung"
);
отбор по товарам с установленным чекбоксом "Распродажа"
$arrFilter = array(
"PROPERTY_SALES" => 1
);
отбор по товарам отобранным компонентом поиска
$arrFilter = array(
"=ID" => $arElements, //arElements - массив с ID найденных товаров
);
*/
$APPLICATION->IncludeComponent(
"kombox:filter",
"",
Array(
...
"FILTER_NAME" => 'arrFilter',
...
),
false
);
$APPLICATION->IncludeComponent(
"bitrix:catalog.section",
".default",
array(
...
"FILTER_NAME" => "arrFilter",
...
)
);
На странице поиска остановлюсь немного подробнее. Общий принцип тот же, но есть несколько моментов.
Для правильной работы, версия фильтра должна быть не меньше, чем 2.5.11.
Буду рассматривать на примере стандартного магазина. Шаблон каталога уже скопирован в шаблон сайта. Поиск по товарам происходит на странице http://site.ru/catalog/?q=футболка, шаблон этой странице находится в шаблоне каталога в файле search.php. В этом файле подключается компонент bitrix:catalog.search, который находится тут же, в папке bitrix, смотрим что там. А там если кратко, то такой код:
Вот перед компонентом bitrix:catalog.section мы и будем вставлять фильтр.
Все стандартно, но есть несколько моментов, параметры SECTION_ID и SECTION_CODE задавать не нужно, т.к. фильтр должен работать по всему каталогу. Нужно задать параметр PAGE_URL, чтобы фильтр работал именно со страницей поиска и не сбрасывал параметр q. Вот, что в итоге получилось:
Поиск футболки с фильтром по производителю и цвету.
Если фильтр работает в режиме ЧПУ, то для поиска, нужно будет еще внести правки в шаблон формы поиска. Дело в том, что по умолчанию форма поиска отправляет запрос на текущий url, и если фильтр установлен, то при новом поисковом запросе, он не будет сброшен. Поэтому идем в шаблон формы поиска, если нужно, то копируем ее в шаблон сайта, находим там тег формы. У меня он был таким:
Нужно прописать абсолютный url к странице поиска. В итоге код должен стать таким:
Все, теперь фильтр будет работать на странице поиска в ЧПУ режиме.
Фильтр на странице поиска
Kombox-фильтр может работать на странице поиска и не только - подробнее
Не работают формы в режиме AJAX
Речь идет о стандартных формах штатного модуля form. Часто их переводят в режим ajax (параметр компонента AJAX_MODE => Y). В режиме ЧПУ эти формы перестают работать в режиме ajax, происходит обновление всей страницы. Чтобы это исправить, вам нужно скопировать шаблон компонента form.result.new в шаблон сайта (как правило, он уже скопирован, так как стандартное отображение формы редко вписывается в дизайн сайта и в 99% его кастомизируют, поэтому вам нужно будет найти нужный шаблон). В шаблоне в файле result_modifier.php (если его нет, то нужно создать) вам нужно прописать такой код: