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

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

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

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 — список значений (select)
  • multiple — список со множественным выбором (select multiple)
  • range — диапазон значений
  • checkbox — выбор чекбоксами
• 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()