Next Generation CMS :: Форум поддержки

Страница плагина: https://github.com/russsiq/ng-x_filter

Версия плагина 0.3.0 включает критические обновления

В текущей версии плагина 0.4.0 реализованы "ползунки": возможность выбора в интервале значений для доп. полей (от и до).

Такие поля должны быть созданы с опцией Тип поля в БД: int - только цифры

[hr /]

[hr /]

## Фильтр записей для NG CMS

Плагин позволяет установить на сайте фильтр записей по категориям и дополнительным полям `xfields` с поддержкой полнотекстового поиска.

Плагин поддерживает дополнительные поля типа **Текстовый** (`input`) и **Выбор значения** (`select`).

Для полей типа `input` создается выборка (дополнительный SQL-запрос) всех возможных значений и отображается в виде выпадающего списка. Данный запрос можно кешировать, установив время в настройках плагина.

### Подготовка к подключению

Перед включением плагина `x_filter`:

1. Установите и включите плагин `xfields`.
2. Создайте необходимые дополнительные поля.
3. При создании дополнительных полей выбирайте опцию:
    - *Режим сохранения данных:* **Персональное поле в БД**.

### Подключение

1. Скачайте архив с плагином и распакуйте содержимое в папку *\engine\plugins\x_filter* вашей CMS.
2. Установите и включите плагин в панели управления.

Для отображения формы фильтра на сайте разместите переменную `{{ x_filter_form }}` в шаблоне **main.tpl**, например в боковой панели:

```html
<aside id="sidebar">
{% if pluginIsActive('x_filter') %}
    <div class="block">
        {{ x_filter_form }}
    </div>
{% endif %}
</aside>
```

Для отображения виджета на сайте используйте функцию вызова `{{ callPlugin('x_filter.widget', {...}) }}` в шаблоне **main.tpl**, например в боковой панели:

```html
<aside id="sidebar">
{% if pluginIsActive('x_filter') %}
    <div class="block">
    {{ callPlugin('x_filter.widget', {
        'page': 1,
        'showNumber': 8,
        'order': 'id_desc',
        'search': 'Какой-нибудь поисковый запрос',
        'catid': 6,
        'skipcat': '2,4',
        'x_price': 179000,
        'x_color': 'красный',
        'cache': true,
        'cacheExpire': 60,
        'template': 'default',
        'extractEmbeddedItems': true
    }) }}
    </div>
{% endif %}
</aside>
```

### Доступные переменные в шаблонах

#### Шаблон плагина `filter_form.tpl`

- `{{ plugin_link }}` - ссылка на главную страницу плагина
- `{{ catid }}` - `id` текущей категории
- `{{ search }}` - поисковое слово, если было заполнено пользователем
- `{{ catlist }}` - выпадающий список категорий сайта
- `{{ order }}` - порядок сортировки результатов фильтрации
- `{{ x_имя_доп_поля }}` - выводит выпадающий список существующих значений дополнительного поля текущей категории

#### Шаблон сайта `news.table.tpl`

- `{{ count }}` - количество отфильтрованных записей
- `{{ data }}` - массив отфильтрованных записей
- `{{ pages }}` - информация о страницах:
    - `{{ pages.current }}` - номер текущей страницы
    - `{{ pages.total }}` - количество страниц
- `{{ pagination }}` - HTML-код постраничной навигации

Примерная структура шаблона `news.table.tpl` с выводом количества отфильтрованных новостей:

```html
{% if (pluginIsActive('x_filter') and isHandler('x_filter')) %}
    <h2>{{ lang['x_filter:page_title'] }} <small class="float-right text-muted">{{ count }}</small></h2>
    <hr>
{% endif %}

{% for entry in data %}
    {{ entry }}
{% else %}
    <div class="alert alert-info">{{ lang['msgi_no_news'] }}</div>
{% endfor %}

{{ pagination }}
```

#### Шаблон виджета `widget.tpl`

- `{{ count }}` - количество отфильтрованных записей
- `{{ entries }}` - массив отфильтрованных записей

Примерная структура шаблона `widget.tpl` с выводом количества отфильтрованных новостей:

```html
{% for entry in entries %}
    {{ entry }}
{% endfor %}
```

#### Шаблон виджета `entries.tpl`

- `{{ count }}` - количество отфильтрованных записей
- `{{ entries }}` - массив отфильтрованных записей

Примерная структура шаблона `entries.tpl` с извлеченным изображением:

```html
<article>
    <a href="{{ news.url.full }}">{{ news.title|truncateHTML(70,'...') }}</a>
    <span>{{ news.author.name }}, {{ news.categories.masterText }}</span>
    <span>{{ p.xfields.price.value }}</span>
    <div class="article-img" style="overflow: hidden;">
        {% if (news.embed.imgCount > 0) %}
            <img src="{{ news.embed.images[0] }}" width="315" height="161"/>
        {% else %}
            <img src="{{ tpl_url }}/img/img-none.png" width="315" height="161"/>
        {% endif %}
    </div>
</article>
```

### Дополнительно можно настроить:

- категории, которые следует скрывать из выпадающего списка категорий, формируемом переменной `{{ catlist }}`
- возможность выбора из всех категорий (в списке категорий будет установленное по умолчанию значение "- все -")
- порядок вывода новостей и их количество на странице
- расположение шаблона (шаблон сайта / шаблон плагина)
- опциональное встраивание на страницу файла CSS из шаблона
- опциональное встраивание на страницу файла JavaScript из шаблона
- возможность задания страницам фильтра канонической ссылки
- возможность запрета индексации страниц фильтра поисковыми роботами

### Лицензия

`ng-x_filter` - программное обеспечение с открытым исходным кодом, распространяющееся по лицензии [MIT](LICENSE).