Онлайн-руководство разработчика NetCat
Модуль «Поиск по сайту» 12.2.1Начало работы с модулем 12.2.2Язык запросов 12.2.3Способы хранения индекса 12.2.4Интерфейс модуля в панели управления сайтом 12.2.5Области индексирования 12.2.6Области HTML-страниц 12.2.7Области поиска на сайте 12.2.8Индексирование по расписанию, запуск индексирования в фоновом режиме 12.2.9Правила индексирования 12.2.10Постановка задачи переиндексирования в очередь 12.2.11Интеграция модуля в макеты дизайна сайта 12.2.12Простая форма поиска 12.2.13Расширенная форма поиска 12.2.14Вывод результатов поиска 12.2.15Стилизация списка подсказок 12.2.16Расширенные настройки 12.2.17Разработка расширений модуля 12.2.18Обзор архитектуры модуля 12.2.19Обработчики документов различных типов 12.2.20Текстовые фильтры 12.2.21Анализаторы текста 12.2.22Корректировщики запросов 12.2.23Подключение других поисковых систем 12.2.24Решение проблем с поиском 12.2.25Решение проблем с индексированием 12.2.26Справочник API

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

Настройка и использование фильтра товаров

Для добавления фильтра товаров необходимо изменить соответствующий компонент так как описано ниже.

1) В системных настройках компонента необходимо добавить инициализацию полей по которым будет фильтроваться продукция и обработчик переменной $query_where добавляющий фильтрующие условия в SQL запрос.

$netshop = nc_netshop::get_instance();
//$netshop->filter->options('ignore_cc', true); //раскомментировать в собирающем разделе с ignore_cc
$netshop->filter->init_fields(array('Vendor', 'Screen', 'Price'));
$netshop->filter->query_where($query_where);

2) В префиксе списка объектов добавляем вывод формы фильтра:

echo $netshop->filter->make_form()

Альтернативный способ построения форм (Кастомизация форм)

Метод make_form возвращает html форму вид которой можно изменить только с помощью таблиц стилей (CSS). Если этого не достаточно, то можно построить форму альтернативным способом.

<form action='' method='post'>
        <?=$netshop->filter->make_field('Vendor') ?>
        <?=$netshop->filter->make_field('Screen') ?>
        <?=$netshop->filter->make_field('Price') ?>
        <button type='submit'>OK</button>
        <input type='submit' name='nc_filter_reset' value='Reset'>
</form>

API ($netshop->filter)

init_fields($fields=array())

Устанавка полей для фильтра товаров

Параметр $fields может быть простым массивом полей:

$netshop->filter->init_fields(array('Price', 'Color', 'Counts'));

или ассоциативным массивом для установки специфических параметров для поля:

$netshop->filter->init_fields(array(
        'Price',
        'Color',
        'Counts' => array(
                'type'    => 'list',
                'label'   => 'Кол-во',
                'options' => array('',1,2,3,4,5,6,7,9)
        ),
));

Доступные параметры поля:

  • type: тип поля.
    • list — список значений
    • range — диапазон значений
  • label: текст для названия поля
  • options: список значения для поля типа "list"
  • bool_label_true: текст для значения «истина» логических полей (доступно с версии 5.7.0.16275)
  • bool_label_false: текст для значения «ложь» логических полей (доступно с версии 5.7.0.16275)

options($key, $value = null)

Устанавливает (если передан аргумент $value) или возвращает (если $value = null) параметр фильтра.

Доступные параметры:

  • filter_values: фильтрация возможных значений полей для текущего установленного фильтра
    • true: фильтр предлагает выбрать только те параметры по которым можно найти товар (значение по умолчанию)
    • false: при установке фильтра будут выводиться все возможные варианты для всех полей, даже если в уже отфильтрованном списке товаров нет подходящих позиций
  • show_fields_without_choice: показывать (true) или скрывать (false, значение по умолчанию) поля, для которых существует только один вариант выбора
  • list_field: элемент, использующийся для текстовых полей и списков (если тип не переопределён в параметрах поля); по умолчанию — select
    • select: выпадающий список
    • multiple: список с возможностью множественного выбора
    • checkbox: набор чекбоксов
  • bool_field: элемент, использующийся для логических полей (если тип не переопределён в параметрах поля); значения те же, что и для "list_field", по умолчанию — checkbox.

$netshop->filter->options('filter_values', false);

query_where(&$query_where)

Добавляет в SQL запрос фильтрующие условия

Функция вызывается в системных настройках компонента:

$netshop->filter->query_where($query_where);

make_form($fields = array())

Гененрирует html форму фильтра

  • Значение поля $fields тоже что и в методе init_fields()

make_field($name)

Гененрирует html фильтрующего поля

  • $name - Название поля

field_value($name)

Возвращает фильтрующее значениея поля

  • $name - Название поля

get_fields($fields = array())

Возвращает массив полей с установленными параметрами

  • Значение поля $fields тоже что и в методе init_fields()

Комментарии 5

Дмитрий  Life-work 07 мая 2014, 01:30:21
Фильтры работают только в конечной рубрике каталога, где лежат товары, а в верхних собирающих разделах игнорируются.
   
Elart  Elart 22 июля 2014, 12:11:40
В коде альтернативной формы еще нужно указать переменную:

[CODE]<input type="hidden" name="nc_filter_set" value="1">[/CODE]

Без нее фильтр рабоать не будет.
   
Дмитрий  Life-work 21 августа 2014, 16:58:17
Фильтры не видят значений у вариантов товара.
Например, цена от и до работает только если она есть у основного товара, а это зачастую не так.
   
Jack  Batiskaff.ru 30 июня 2016, 16:26:24
В инфоблоках, где Sub_Class_ID не совпадает с родным для товара, при указании
$netshop->filter->options('ignore_cc', true);
$netshop->filter->query_where($query_where);
при отображении фильтра не учитываются параметры из $query_where.
Т.е. к $query_where параметры фильтра добавляются, а наоборот нет.
Например, в основном ифоблоке имеется 100 товаров, а в зеркальном делается выборка товаров с пользовательскими критериями и в списке остается 20. При этом фильтр отображается, но выдает параметры фильтрации для всех 100 товаров, которые находятся в основном инфоблоке, а не для 20 выбраных.
Посмотрели код класса nc_netshop_filter и обнаружили, что обратная конкатенация параметра $query_where к фильтру в принципе не предусмотрена и имеет смысл только при зеркалировании всего инфоблока. И обойти это никак не получается без написания своих фильтров. Хотелось, бы чтобы была такая возможность в будущем.
   
pavlpicasso  Паршиков Павел 24 августа 2016, 08:19:18
Возможно ли отображение фильтра категории на главной, без отображения карточек товаров? То есть отображаем фильтр, при нажатии "применить фильтр" переход на каталог с товарами с применением фильтра.
   
Описание проекта