DLE Filter

Лучший фильтр новостей для DataLife Engine.

Стилизация из коробки

  • Кроссбраузерная поддержка. Chrome, Firefox, Opera, Safari, IE9+
  • Поддержка «JavaScript Tail.Select» для стилизации элемента SELECT.
  • Поддержка «JavaScript Chosen» для стилизации элемента SELECT.
  • Поддержка «JavaScript Nice Select» для стилизации элемента SELECT.
  • Поддержка «JavaScript Ion.RangeSlider» для создания слайдера (ползунка).

Функционал

  • Кэширование результатов фильтра.
  • Возможность искать новости только в рамках категории, тега, дополнительного поля на котором находиться пользователь сайта.
  • Возможность задать количество новостей на страницу фильтра.
  • Автоматическая очистка данных статистики после N дней.
  • Возможность установить сортировку новостей по умолчанию.
  • Возможность исключить категории с фильтра.
  • Возможность исключить новости с фильтра.
  • AJAX подгрузка результатов фильтра.
  • При AJAX подгрузке меняется: Мета-тег Title, Хлебные крошки, URL страницы.
  • Возможность убрать AJAX подгрузку фильтра.
  • Возможность искать только по нажатию на кнопку с AJAX подгрузкой.
  • Возможность искать только по нажатию на кнопку с перенаправлением на страницу фильтра.
  • Возможность включить AJAX навигацию в фильтре.
  • Возможность отключить анимацию автоматического поднятия к контенту при использовании AJAX навигации.
  • Возможность отключить стандартную анимацию предзагрузки AJAX результата.
  • Возможность отключить изменение URL при AJAX работе модуля.
  • Поддержка отдельного тега {navigation}.
  • Интеграция с сторонними модулями.
  • Возможность указывать шаблон результата фильтра в зависимости от параметра фильтра.
  • Возможность добавлять скрыто параметры в зависимости от параметров фильтра.
  • Возможность скрывать и показывать нужные блоки в форме фильтра в зависимости от нужного значения другого элемента формы фильтра.
  • Возможность искать по всем полям новости.
  • Возможность в слайдере использовать дополнительные поля и рейтинг новости.
  • Кнопка сброса фильтра и результата поиска фильтра.
  • Множество параметров для поиска новостей.
  • Возможность установить максимальное количество найденных новостей.
  • Возможность показывать только новости которые опубликованы на главной.
  • Возможность выводить зафиксированные новости как обычно - закрепленными перед другими или же вместе с другими.
  • Возможность включить и настроить более быстрый тип поиска новостей с меньшей нагрузкой на базу данных.
  • И много другого.

SEO

  • Возможность задать Мета-тег Robots для страницы фильтра в зависимости от параметров фильтра или же в настройках для первой и остальных страниц.
  • Гибкая SEO оптимизация страниц фильтра.
  • Обработка неверных URL фильтра.
  • Запись статистики для отслеживания что ищут пользователи Вашего сайта.
  • Редирект с несуществующих страниц пагинации в фильтре.
  • Код ответа сервера 404 если не найдено новостей в фильтре.
  • Человеко понятный урл, ЧПУ.
  • Дополнительные теги для страницы фильтра.
  • Возможность создавать готовые страницы фильтра с SEO оптимизацией.
  • Возможность указать свой URL фильтра.

Совместимость

Установка

  • Шаг первый

    Загрузите файлы с папки Module на свой сервер, предварительно изменив название папки {THEME} на название своего шаблона.

  • Шаг второй

    Установить через систему плагинов XML файл dle-filter.xml с указанной версией движка.

  • Шаг третий

    В main.tpl вашего шаблона, перед тегом

    </body>
    Вставить
    <link href="{THEME}/lazydev/dle_filter/assets/dle_filter.css" type="text/css" rel="stylesheet">
<script src="/engine/lazydev/dle_filter/lib/dle_filter.js.php" defer></script>
<script src="{THEME}/lazydev/dle_filter/assets/dle_filter.js" defer></script>

  • Шаг четвертый

    Откройте файл .htaccess в корне сайта, где index.php, и после кода
    RewriteEngine On
    Вставить
    #DLE Filter
RewriteRule ^tags/([^/]*)/f/(.*)(/?)$ index.php?do=dle_filter&tag=$1&filter_data=$2 [L]
RewriteRule ^xfsearch/(.*)/f/(.*)(/?)$ index.php?do=dle_filter&xf=$1&filter_data=$2 [L]
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^([^.]+)/f/(.*)(/?)$ index.php?do=dle_filter&cat=$1&filter_data=$2 [L]
RewriteRule ^f/(.*)(/?)$ index.php?do=dle_filter&filter_data=$1 [L]

    Откройте файл конфигурации NGINX и перед
    rewrite "^/page/([0-9]+)(/?)$" /index.php?cstart=$1 last;
    Вставьте
    rewrite "^/tags/([^/]*)/f/(.*)(/?)+$" /index.php?do=dle_filter&tag=$1&filter_data=$2 last;
rewrite "^/xfsearch/(.*)/f/(.*)(/?)+$" /index.php?do=dle_filter&xf=$1&filter_data=$2 last;
if (!-d $request_filename) {
	rewrite "^/([^.]+)/f/(.*)(/?)+$" /index.php?do=dle_filter&cat=$1&filter_data=$2 last;
}
rewrite "^/f/(.*)(/?)+$" /index.php?do=dle_filter&filter_data=$1 last;

Обновление на версию 2.6.1

  • Шаг первый

    Обновите плагин модуля dle-filter.xml с указанной версией движка.

  • Шаг второй

    Обновите все файлы в папке /engine/lazydev/dle_filter кроме папки /engine/lazydev/dle_filter/data

  • Шаг третий

    Обновите файл /templates/Ваш_Шаблон/lazydev/dle_filter/assets/dle_filter.js

  • Шаг четвертый

    Проверьте наличие параметра defer у скриптов модуля которые подключены в main.tpl

Начало работы

Для того чтобы начать взаимодействовать с фильтром Вам нужно добавить его форму 

<form data-dlefilter="dle-filter">

	<input type="button" data-dlefilter="submit" value="Поиск">
	<input type="button" data-dlefilter="reset" value="Очистить">
</form>

Тогда к вашему тегу <form> нужно добавить параметр
data-dlefilter="dle-filter"
К кнопке поиска добавить параметр
data-dlefilter="submit"
К кнопке сброса данных в форме добавить параметр
data-dlefilter="reset"

Дальше вы задаете внутри тега <form> разные элементы с которыми будет взаимодействовать пользователь сайта.

<input name="PARAM" value="VALUE" type="text"> - Текстовое поле
<input name="PARAM" value="VALUE" type="checkbox"> - Выбор флажков
<input name="PARAM" value="VALUE" type="radio"> - Переключатели

<select name="PARAM"> - Выпадающий список с выбором одного значения
	<option value="VALUE">Раз</option>
	<option value="VALUE">Два</option>
	<option value="VALUE">Три</option>
</select>

<select name="PARAM" multiple> - Выпадающий список с выбором нескольких значений
	<option value="VALUE">Раз</option>
	<option value="VALUE">Два</option>
	<option value="VALUE">Три</option>
</select>

Все эти элементы вы можете оформлять как угодно и стилизировать любыми js скриптами.

Как видно из перечисленых выше элементов формы, для того что бы работал верно фильтр, нужно указывать параметры и значения

Параметры:

  1. Название дополнительного поля на латинице - В параметр передается название дополнительного поля.

    Посмотреть примеры

  2. sort - Этот параметр служит по какой ячейке сортировать новости, параметр принимает следующие значения (value):
    1. date - Дата добавления новости.
    2. editdate - Дата редактирования новости.
    3. title - Название новости.
    4. comm_num - Количество комментариев.
    5. news_read - Количество просмотров.
    6. rating - Рейтинг новости.
    7. autor - Автор новости.
    8. Название дополнительного поля на латинице - Для сортировки по дополнительному полю.
    9. d.Название дополнительного поля на латинице - Для сортировки по числовым данным дополнительного поля.
    Кроме того можно задавать как именно сортировать по выбранному полю (по убыванию или по возростанию) через точку с запятой ;

    Посмотреть примеры

    Если у вас есть модуль DLE Emote Lite вы можете так же использовать следующие значения для value:

    1. emote_one - Первая эмоция.
    2. emote_two - Вторая эмоция.
    3. emote_three - Третья эмоция.
    4. emote_four - Четвертая эмоция.
    5. emote_five - Пятая эмоция.
    6. emote_six - Шестая эмоция.

  3. order - Этот параметр служит для типа сортировки новостей, по-убыванию или по-возростанию, если в параметре sort вы этого не указали через точку с запятой. Параметр принимает следующие значения (value):
    1. asc - По возрастанию.
    2. desc - По убыванию.

    Посмотреть примеры

  4. cat - Этот параметр ищет новости строго по выбранным категориям, это значит если выбрать две или больше категорий то фильтр будет искать новости которые содержат все выбранные категории. Параметр принимает id категорий.

    Посмотреть примеры

  5. o.cat - Этот параметр ищет новости по выбранным категориям, отличие от параметра cat состоит в том, что фильтр будет искать новости которые содержат хотя бы одну из выбраных категорий. Параметр принимает id категорий.

    Посмотреть примеры

  6. p.cat - Этот параметр ищет новости по родительськой категории. Это значит что id родительськой категории и все ее подкатегории будут автоматически включены в выборку новостей. Параметр принимает id родительських категорий.

    Посмотреть примеры

  7. l.X - Этот параметр ищет новости по указаной ячейке (вместо X подставляете название ячейки) с таблицы _post и _post_extras используя неточный поиск. Параметр принимает следующие значения (X):
    1. id - ID новости [ Принимает числовое значение ]
    2. autor - Автор новости.
    3. date - Дата добавления.
    4. short_story - Краткая новость.
    5. full_story - Полная новость.
    6. title - Заголовок новости.
    7. descr - Мета Description.
    8. keywords - Мета Keywords.
    9. comm_num - Количество комментариев [ Принимает числовое значение ]
    10. allow_comm - Разрешены комментарии [ Принимает значение 1 - да, 0 - нет ]
    11. allow_main - Показ новости на главной [ Принимает значение 1 - да, 0 - нет ]
    12. approve - Прошла модерацию новость [ Принимает значение 1 - да, 0 - нет ]
    13. fixed - Зафиксирована новость [ Принимает значение 1 - да, 0 - нет ]
    14. symbol - Символ.
    15. tags - Теги.
    16. metatitle - Мета Title.
    17. news_read - Количество просмотров новости [ Принимает числовое значение ]
    18. allow_rate - Разрешен рейтинг [ Принимает значение 1 - да, 0 - нет ]
    19. rating - Рейтинг [ Принимает числовое значение ]
    20. vote_num - Количество голосов [ Принимает числовое значение ]
    21. votes - Опрос в новости [ Принимает значение 1 - да, 0 - нет ]
    22. disable_index - Запрещено для индексации [ Принимает значение 1 - да, 0 - нет ]
    23. editor - Автор редактирования.
    24. reason - Причина редактирования.
    25. user_id - ID пользователя [ Принимает числовое значение ]
    26. disable_search - Запрещено для поиска [ Принимает значение 1 - да, 0 - нет ]

    Посмотреть примеры

  8. m.X - Этот параметр ищет новости по указаной ячейке (вместо X подставляете название ячейки) с таблицы _post и _post_extras используя регулярный поиск. Одним словом все тоже самое что и l.X параметр, только точнее и чуть медленей. Параметр принимает следующие значения (X):
    1. id - ID новости [ Принимает числовое значение ]
    2. autor - Автор новости.
    3. date - Дата добавления.
    4. short_story - Краткая новость.
    5. full_story - Полная новость.
    6. title - Заголовок новости.
    7. descr - Мета Description.
    8. keywords - Мета Keywords.
    9. comm_num - Количество комментариев [ Принимает числовое значение ]
    10. allow_comm - Разрешены комментарии [ Принимает значение 1 - да, 0 - нет ]
    11. allow_main - Показ новости на главной [ Принимает значение 1 - да, 0 - нет ]
    12. approve - Прошла модерацию новость [ Принимает значение 1 - да, 0 - нет ]
    13. fixed - Зафиксирована новость [ Принимает значение 1 - да, 0 - нет ]
    14. symbol - Символ.
    15. tags - Теги.
    16. metatitle - Мета Title.
    17. news_read - Количество просмотров новости [ Принимает числовое значение ]
    18. allow_rate - Разрешен рейтинг [ Принимает значение 1 - да, 0 - нет ]
    19. rating - Рейтинг [ Принимает числовое значение ]
    20. vote_num - Количество голосов [ Принимает числовое значение ]
    21. votes - Опрос в новости [ Принимает значение 1 - да, 0 - нет ]
    22. disable_index - Запрещено для индексации [ Принимает значение 1 - да, 0 - нет ]
    23. editor - Автор редактирования.
    24. reason - Причина редактирования.
    25. user_id - ID пользователя [ Принимает числовое значение ]
    26. disable_search - Запрещено для поиска [ Принимает значение 1 - да, 0 - нет ]

    Посмотреть примеры

  9. s.X - Этот параметр ищет новости по указаной ячейке (вместо X подставляете название ячейки) с таблицы _post и _post_extras используя сопоставление данных как равно. Параметр не подходит к ячейкам которые содержат несколько данных которые перечислены через запятую или другой символ. Параметр подходит для одиночного поиска. Параметр принимает следующие значения (X):
    1. id - ID новости [ Принимает числовое значение ]
    2. autor - Автор новости.
    3. date - Дата добавления.
    4. short_story - Краткая новость.
    5. full_story - Полная новость.
    6. title - Заголовок новости.
    7. descr - Мета Description.
    8. keywords - Мета Keywords.
    9. comm_num - Количество комментариев [ Принимает числовое значение ]
    10. allow_comm - Разрешены комментарии [ Принимает значение 1 - да, 0 - нет ]
    11. allow_main - Показ новости на главной [ Принимает значение 1 - да, 0 - нет ]
    12. approve - Прошла модерацию новость [ Принимает значение 1 - да, 0 - нет ]
    13. fixed - Зафиксирована новость [ Принимает значение 1 - да, 0 - нет ]
    14. symbol - Символ.
    15. tags - Теги.
    16. metatitle - Мета Title.
    17. news_read - Количество просмотров новости [ Принимает числовое значение ]
    18. allow_rate - Разрешен рейтинг [ Принимает значение 1 - да, 0 - нет ]
    19. rating - Рейтинг [ Принимает числовое значение ]
    20. vote_num - Количество голосов [ Принимает числовое значение ]
    21. votes - Опрос в новости [ Принимает значение 1 - да, 0 - нет ]
    22. disable_index - Запрещено для индексации [ Принимает значение 1 - да, 0 - нет ]
    23. editor - Автор редактирования.
    24. reason - Причина редактирования.
    25. user_id - ID пользователя [ Принимает числовое значение ]
    26. disable_search - Запрещено для поиска [ Принимает значение 1 - да, 0 - нет ]

    Посмотреть примеры

  10. f.X - Этот параметр служит для выборки по диапазону ОТ, параметр принимает следующие значения (value):
    1. Название дополнительного поля на латинице - Для поиска по дополнительному полю.
    2. prate - Для поиска по рейтингу новости.
    3. pdate - Для поиска по дате добавления новости. Принимает значения вида: 2019-09-03
    4. pedit - Для поиска по дате редактирования новости. Принимает значения вида: 2019-09-03

    Посмотреть примеры

  11. t.X - Этот параметр служит для выборки по диапазону ДО, параметр принимает следующие значения (value):
    1. Название дополнительного поля на латинице - Для поиска по дополнительному полю.
    2. prate - Для поиска по рейтингу новости.
    3. pdate - Для поиска по дате добавления новости. Принимает значения вида: 2019-09-03
    4. pedit - Для поиска по дате редактирования новости. Принимает значения вида: 2019-09-03

    Посмотреть примеры

  12. c.X - Этот параметр служит для работы выборки по диапазану ОТ и ДО одновременно, где X - название дополнительного поля на латинице или prate для рейтинга новости.

    Посмотреть примеры

  13. j. - Этот параметр служит для объединения нескольких ячеек в одну и поиск по соединеным данным.

    Посмотреть примеры

  14. g.X - Этот параметр проверяет дополнительное поле на наличие данных, где X - название дополнительного поля на латинице. Будут показаны новости у которых указанное дополнительное поле не пустое.

    Посмотреть примеры

  15. e.X - Этот параметр проверяет дополнительное поле на наличие данных, где X - название дополнительного поля на латинице. Будут показаны новости у которых указанное дополнительное поле пустое.

    Посмотреть примеры

  16. v.X - Этот параметр проверяет дополнительное поле на наличие данных, где X - название дополнительного поля на латинице. Будут показаны новости у которых указанное дополнительное не содержит указанное значение.

    Посмотреть примеры

  17. b.X - Этот параметр ищет новости строго по значению дополнительного поля, где X - название дополнительного поля на латинице. Отлично подходит для дополнительных полей которые хранят только одно значение.

    Посмотреть примеры

  18. n. - Этот параметр изменяет поиск других параметров с ИЛИ на И.
    Поддерживаемые параметры
    1. l.
    2. s.
    3. m.
    4. Название дополнительного поля на латинице

    Посмотреть примеры

  19. ! - Этот параметр делает исключение искомых данных, работает со всеми параметрами КРОМЕ
    1. r.
    2. c.
    3. o.cat
    4. p.cat
  20. !cat - Этот параметр исключает категории из поиска. Работает также как параметр cat только наоборот.

Работа с ползунком [ Ion.RangeSlider ]

Для начала нужно включить поддержку скрипта в админ панели модуля в разделе «Настройки JS»

Слайдер работает только с элементом input текстового типа и имеет параметр r. и принимает следующие значения

  • Название дополнительного поля на латинице - В параметр передается название дополнительного поля.
  • prate - Параметр для поиска по рейтингу новости с помощью слайдера (ползунка).
  • date - Параметр для поиска по дате добавления новости с помощью слайдера (ползунка).
  • edit - Параметр для поиска по дате редактирования новости с помощью слайдера (ползунка).

Также вы можете настроить слайдер (ползунок) с помощью параметра data-slider-config="" который прописывается в input.
Параметры слайдера разделяются точкой с запятой а значение параметра через двоеточие.
Перечень всех настроек Ion.RangeSlider

Параметр Значение Описание
АвтоПолзунок - Автоматический поиск новостей после того как отпустили ползунок в слайдере.
Двойной слайдер - Создает слайдер с двумя ползунками.
Одиночный слайдер - Создает слайдер с одним ползунком.
Минимальное значение число Задает минимальное значение слайдера.
Максимальное значение число Задает максимальное значение слайдера.
Начало слайдера число Задает позицию первого ползунка.
Конец слайдера число Задает позицию второго ползунка. Только для двойного слайдера.
Шаг число Задает сколько проходить за одно перетаскивание ползунка.
Шаблон flat - Flat skin
big - Big skin
modern - Modern skin
sharp - Sharp skin
round - Round skin
square - Square skin
 Устанавливает дизайн слайдера.
Префикс строка Задает префикс для значений на ползунках.
Постфикс строка Задает постфикс для значений на ползунках.
Сетка - Создает под слайдером сетку значений.
Красивые числа - Преобразовывает слитые числа в читаемые. Было - 100000, стало - 100 000.
Скрыть MinMax - Скрывает на слайдере максимальное и минимальное значение.
Скрыть FromTo - Скрывает на слайдере значения ползунков.

Пример слайдера (ползунка):

Создание слайдера для дополнительного поля «year»
<input name="r.year" data-slider-config="Двойной слайдер;Минимальное значение:2010;Максимальное значение:2020;Начало слайдера:2015;Конец слайдера:2020;Шаг:1;" value="" type="text">

Пример слайдера (ползунка) для поиска по рейтингу новости:

<input name="r.prate" data-slider-config="Двойной слайдер;Сетка;Минимальное значение:1;Максимальное значение:5" value="" type="text">

Создание слайдера (ползунка) для поиска по дате добавления или редактирования новости

Обязательным является параметр data-slider-type="date" иначе слайдер будет работать некорректно.

Задавать значения нужно через запятую в последовательности: Год,Месяц,День без пробелов и в числовом формате.

Для поиска по дате добавления новости в name="" нужно прописывать r.date

Для поиска по дате редактирования новости в name="" нужно прописывать r.edit

Параметр data-slider-lang="ru-RU" позволяет задать локализацию даты на слайдере, поддерживает русский и английский язык

  • ru-RU - для русской локализации.
  • en-US - для английской локализации.
  • uk - для украинской локализации.

Пример слайдера (ползунка) по дате добавления новости:

<input name="r.date" data-slider-config="Двойной слайдер;Сетка;Минимальное значение:2020,01,01;Максимальное значение:2020,12,31" data-slider-type="date" data-slider-lang="ru-RU" value="" type="text">

Работа с Tail.Select

Для начала нужно выбрать поддержку скрипта в админ панели модуля в разделе «Настройки JS»

Tail.Select работает только с элементом select

Также для Tail.Select есть настройки которые задаются в data-select-config="" который прописывается в select.
Параметры не являются обязательным.
Параметры разделяются точкой с запятой а значение параметра через двоеточие.
Перечень всех настроек Tail.Select

Параметр Значение Описание
Поиск - Включает возможность искать в выпадающем списке.
Скрыть выбранные - Скрывает в выпадающем списке выбранные данные.
Максимум выбрать число Задает количество максимального выбора значений в выпадающем списке.
Показать количество выбранных - Показывает сколько пользователь выбрал значений в выпадающем списке. Не работает с параметром Вывод выбранных
Вывод выбранных - Показывает выбранные данные. Не работает с параметром Показать количество выбранных
Подсказка текст Задает подсказку для выпающего списка (placeholder).
Сортировать ASC - По возрастанию
DESC - По убыванию
 Сортирует значения в выпадающем списке.

Пример параметров:

<select data-select-config="Поиск;Скрыть выбранные;Вывод выбранных;Сортировать:ASC" name="cat">
	<option value="">Любая категория</option>
	<option value="1">Заготовки</option>
	<option value="3">Выпечка и десерты</option>
	<option value="7">Основные блюда</option>
	<option value="4">Завтраки</option>
	<option value="5">Салаты</option>
	<option value="11">Супы</option>
	<option value="12">Закуски</option>
	<option value="13">Напитки</option>
</select>

SEO оптимизация страниц фильтра

Все SEO данные задаются вручную и находяться в файле /templates/Ваш_Шаблон/lazydev/dle_filter/seo.tpl

Внутри этого файла доступны 4 основных тега и 1 дополнительный из которых беруться данные.

  • [meta-title] Данные [/meta-title] — тег отвечает за Метатег Title на странице фильтра. Все данные внутри него будут показаны в Метатег Title.
  • [meta-description] Данные [/meta-description] — тег отвечает за Метатег Description на странице фильтра. Все данные внутри него будут показаны в Метатег Description.
  • [meta-keywords] Данные [/meta-keywords] — тег отвечает за Метатег Keywords на странице фильтра. Все данные внутри него будут показаны в Метатег Keywords.
  • [meta-speedbar] Данные [/meta-speedbar] — тег отвечает за Хлебные крошки (speedbar) на странице фильтра. Все данные внутри него будут показаны в Хлебных крошках (speedbar) если он включен или доступен для показа на странице фильтра.
  • [meta-robots] Данные [/meta-robots] — тег отвечает за Meta Robots, внутри вы можете настроить его под свои нужды используя условия которые описаны ниже. Внутри должны быть только данные index,follow,noindex,nofollow.

В каждом из выше перечисленых тегов доступны следующие теги

Тег Описание 
[name] {name} [/name]
 Выведет значения выбранные с фильтра, где name это ваши данные из name параметра элемента формы. 
{r.NAME.from}
 Выведет начало полузнка слайдера, где name это ваши данные из name параметра элемента формы. 
{r.NAME.to}
 Выведет конец полузнка слайдера, где name это ваши данные из name параметра элемента формы. 
{filter-page}
 Выведет номер текущей страницы фильтра кроме первой. 
[filter-page] текст [/filter-page]
 Выведет текст внутри тегов если страница больше первой. 
{page-xf}
 Выведет значение дополнительного поля с страницы дополнительного поля. 
[page-xf] текст [/page-xf]
 Выведет текст внутри тегов если есть данные с страницы дополнительного поля. 
[not-page-xf] текст [/not-page-xf]
 Выведет текст внутри тегов если нет данных с страницы дополнительного поля. 
{page-tag}
 Выведет значение тега с страницы тега. 
[page-tag] текст [/page-tag]
 Выведет текст внутри тегов если есть данные с страницы тега. 
[not-page-tag] текст [/not-page-tag]
 Выведет текст внутри тегов если нет данных с страницы тега. 
{page-cat}
 Выведет название категории с страницы категории. 
[page-cat] текст [/page-cat]
 Выведет текст внутри тегов если есть данные с страницы категории. 
[not-page-cat] текст [/not-page-cat]
 Выведет текст внутри тегов если нет данных с страницы категории. 
{NAME limit=4}
 Выведет первые 4 значения которые разделены запятой, где NAME это название параметра. 
{NAME limit=4;end}
 Выведет первые 4 значения, но с конца, которые разделены запятой, где NAME это название параметра. 
{r.date.from date=X}
 Выводит дату с слайдера по поиску даты добавления новости ОТ в заданном в теге формате. Тем самым вы можете выводить не только дату целиком но и ее отдельные части. Формат даты задается согласно формату принятому в PHP. Например тег {date=d} выведет день месяца, а тег {date=F} выведет название месяца, а тег {date=d-m-Y} выведет день месяц и год. 
{r.date.to date=X}
 Выводит дату с слайдера по поиску даты добавления новости ДО в заданном в теге формате. Тем самым вы можете выводить не только дату целиком но и ее отдельные части. Формат даты задается согласно формату принятому в PHP. Например тег {date=d} выведет день месяца, а тег {date=F} выведет название месяца, а тег {date=d-m-Y} выведет день месяц и год. 
{r.edit.from date=X}
 Выводит дату с слайдера по поиску даты редактирования новости ОТ в заданном в теге формате. Тем самым вы можете выводить не только дату целиком но и ее отдельные части. Формат даты задается согласно формату принятому в PHP. Например тег {date=d} выведет день месяца, а тег {date=F} выведет название месяца, а тег {date=d-m-Y} выведет день месяц и год. 
{r.edit.to date=X}
 Выводит дату с слайдера по поиску даты редактирования новости ОТ в заданном в теге формате. Тем самым вы можете выводить не только дату целиком но и ее отдельные части. Формат даты задается согласно формату принятому в PHP. Например тег {date=d} выведет день месяца, а тег {date=F} выведет название месяца, а тег {date=d-m-Y} выведет день месяц и год. 
{count-news}
 Выведет количество новостей. 
[count-news] текст [/count-news]
 Выведет текст внутри тегов если есть найденные новости. 
[not-count-news] текст [/not-count-news]
 Выведет текст внутри тегов если найденных новостей нет. 
[dle-filter declination={count-news}]новост|ь|и|ей[/declination]
 Выведет склоненное слово. Вместо тега {count-news} может быть любой другой который содержит только целое число. 
[if name] текст [/if]
 Выведет текст внутри тегов если данный параметр был выбран в форме фильтра и имеет данные. 
[if !name] текст [/if]
 Выведет текст внутри тегов если данный параметр не был выбран в форме фильтра или нет имеет данных. 
[if name=текст] текст [/if]
 Выведет текст внутри тегов если параметр имеет значение равно указанному тексту. 
[if name!=текст] текст [/if]
 Выведет текст внутри тегов если параметр имеет значение не равно указанному тексту. 
[if name==текст,текст2] текст [/if]
 Выведет текст внутри тегов если параметр имеет значение текст и текст2. 
[if name!==текст,текст2] текст [/if]
 Выведет текст внутри тегов если значение параметра не имеет текст и текст2. 
[if name>100] текст [/if]
 Выведет текст внутри тегов если параметр имеет значение строго больше 100. 
[if name>=55] текст [/if]
 Выведет текст внутри тегов если параметр имеет значение больше либо равно 55. 
[if name<300] текст [/if]
 Выведет текст внутри тегов если параметр имеет значение строго меньше 300. 
[if name<=444] текст [/if]
 Выведет текст внутри тегов если параметр имеет значение меньше или равно 444. 
[if name~кофе] текст [/if]
 Выведет текст внутри тегов если в значении параметра встречается слово кофе. 
[if name!~кофе] текст [/if]
 Выведет текст внутри тегов если в выбранном значении параметра НЕ встречается слово кофе. 
[if r.name.from>100] текст [/if]
 Выведет текст внутри тегов если первый ползунок слайдера больше 100. 
[if r.name.to<300] текст [/if]
 Выведет текст внутри тегов если второй ползунок слайдера меньше 300. 
[if xf.name=year] текст [/if]
 Выведет текст внутри тегов если название дополнительного поля, с страницы дополнительного поля, равно year. 
[if xf.value=2077] текст [/if]
 Выведет текст внутри тегов если значение дополнительного поля, с страницы дополнительного поля, равно 2077. 
[if tag.value=новости] текст [/if]
 Выведет текст внутри тегов если значение тега, с страницы тега, равно новости. 
[if cat.id=33] текст [/if]
 Выведет текст внутри тегов если ID категории, с страницы категории, равно 33. 
[if cat.name=Информация] текст [/if]
 Выведет текст внутри тегов если название категории, с страницы категории, равно Информация. 
[if ...] текст [elif ...] текст [/elif][elif ...] текст [/elif][else] текст [/if]
 Также доступны условия elseif в сокращенной форме elif, их количество не ограничено. 
[if name=new]
	Новая 
	[if1 name>50 || name>1000]
		популярная 
		[else1]
		не популярная 
	[/if1]
	новость
[/if]
 Вложенные условия. 
[if r.sell.from>1000 || r.rating.from>50 && name=new]Продаваемый товар![/if]
 В условиях вы можете использовать логические операторы И (&&) и ИЛИ (||).

Посмотреть примеры

Настройка «Нового Поиска»

Если вы хотите использовать новый поиск по дополнительным полям, то нужно настроить свои дополнительные поля в админ панели модуля, а имено в разделе «Дополнительные поля». [ Не рекомендуется использовать на слабых серверах или при постоянном грабинге / парсинге новостей по несколько сотен. ] После чего вы увидите все дополнительные поля, которым нужно настроить их тип данных: Целое число, Число с плавающей точкой (запятой), Текст, или дополнительное поле которое не будет использоваться в фильтре, поэтому ставим ему статус Выключить: Как выставили всем дополнительным полям их статус, нажмите на кнопку «Сохранить» и ждите завершения «Обработки данных».

Теги модуля

Доступны все теги что и в краткой новости.
Тег Описание 
{site-url}
 Ссылка на главную страницу сайта. 
{site-name}
 Краткое название сайта. 
{separator}
 Разделитель в хлебных крошках. 
[first] текст [/first]
 Выводит текст внутри тегов на первой странице фильтра. 
[second] текст [/second]
 Выводит текст внутри тегов на страницах навигации фильтра, т.е. вторая и дальше. 
{filter-url}
 Ссылка на страницу фильтра с выбранными параметрами. 
{filter-name}
 Данные с тегов [meta-speedbar] ... [/meta-speedbar] в файле seo.tpl. 
{page-descr}
 Стандартный текст - "Страница". 
{page}
 Номер страницы.
Информация

Данные теги будут работать в любом вашем tpl файле, который будет доступен для показа на странице фильтра.

Тег Описание 
{dle-filter count-news}
 Выведет количество найденных новостей на странице фильтра. 
[dle-filter count-news] любой текст [/dle-filter]
 Выведет текст на странице фильтра если есть найденные новости. 
[not-dle-filter count-news] любой текст [/not-dle-filter]
 Выведет текст на странице фильтра если нет найденных новостей. 
{dle-filter page}
 Выведет номер текущей страницы фильтра кроме первой. 
[dle-filter page] текст [/dle-filter]
 Выведет текст внутри тегов если страница больше первой. 
[not-dle-filter page] текст [/not-dle-filter]
 Выведет текст внутри тегов если это первая страница. 
{dle-filter NAME}
 Данные с тегов Выведет выбранные данные NAME параметра. 
[dle-filter NAME] любой текст [/dle-filter]
 Выведет текст на странице фильтра если указанный NAME параметр выбран в форме фильтре. 
[not-dle-filter NAME] любой текст [/not-dle-filter]
 Выведет текст на странице фильтра если указанный NAME параметр не выбран в форме фильтре. 
[dle-filter name] текст [/dle-filter]
 Выведет текст внутри тегов если параметр был выбран в форме фильтра и имеет данные. 
[dle-filter !name] текст [/dle-filter]
 Выведет текст внутри тегов если параметр не был выбран в форме фильтра или не имеет данных. 
[dle-filter name=текст] текст [/dle-filter]
 Выведет текст внутри тегов если параметр имеет значение равно указанному тексту. 
[dle-filter name!=текст] текст [/dle-filter]
 Выведет текст внутри тегов если параметр имеет значение не равно указанному тексту. 
[dle-filter name==текст,текст2] текст [/dle-filter]
 Выведет текст внутри тегов если параметр имеет значение текст и текст2. 
[dle-filter name!==текст,текст2] текст [/dle-filter]
 Выведет текст внутри тегов если значение параметра не имеет текст и текст2. 
[dle-filter name>100] текст [/dle-filter]
 Выведет текст внутри тегов если параметр имеет значение строго больше 100. 
[dle-filter name>=55] текст [/dle-filter]
 Выведет текст внутри тегов если параметр имеет значение больше либо равно 55. 
[dle-filter name<300] текст [/dle-filter]
 Выведет текст внутри тегов если параметр имеет значение строго меньше 300. 
[dle-filter name<=444] текст [/dle-filter]
 Выведет текст внутри тегов если параметр имеет значение меньше или равно 444. 
[dle-filter name~кофе] текст [/dle-filter]
 Выведет текст внутри тегов если в значении параметра встречается слово кофе. 
[dle-filter name!~кофе] текст [/dle-filter]
 Выведет текст внутри тегов если в выбранном значении параметра НЕ встречается слово кофе. 
[dle-filter r.name.from] текст [/dle-filter]
 Выведет текст внутри тегов если есть данные первого ползунка слайдера. 
[dle-filter r.name.to] текст [/dle-filter]
 Выведет текст внутри тегов если есть данные второго ползунка слайдера. 
[dle-filter r.name.from>100] текст [/dle-filter]
 Выведет текст внутри тегов если первый ползунок слайдера больше 100. 
[dle-filter r.name.to<300] текст [/dle-filter]
 Выведет текст внутри тегов если второй ползунок слайдера меньше 300. 
{dle-filter r.name.from}
 Выведет значение первого ползунка. 
{dle-filter r.name.to}
 Выведет значение второго ползунка. 
{dle-filter page-xf}
 Выведет значения дополнительного поля на котором происходил поиск фильтра на странице самого фильтра. 
[dle-filter page-xf] текст [/dle-filter]
 Выведет текст внутри тегов если есть данные дополнительного поля со страницы дополнительного поля. 
[not-dle-filter page-xf] текст [/not-dle-filter]
 Выведет текст внутри тегов если нет данных дополнительного поля со страницы дополнительного поля. 
[dle-filter xf.name=year] текст [/dle-filter]
 Выведет текст внутри тегов если название дополнительного поля, со страницы дополнительного поля, равно year. 
[dle-filter xf.value=2077] текст [/dle-filter]
 Выведет текст внутри тегов если значение дополнительного поля, со страницы дополнительного поля, равно 2077. 
{dle-filter page-tag}
 Выведет значение тега со страницы тега. 
[dle-filter page-tag] текст [/dle-filter]
 Выведет текст внутри тегов если есть данные тега со страницы тега. 
[not-dle-filter page-tag] текст [/not-dle-filter]
 Выведет текст внутри тегов если нет данных тега со страницы тега. 
[dle-filter tag.value=новости] текст [/dle-filter]
 Выведет текст внутри тегов если значение тега, со страницы тега, равно новости. 
{dle-filter page-cat}
 Выведет название категории со страницы категории. 
[dle-filter page-cat] текст [/dle-filter]
 Выведет текст внутри тегов если есть данные категории со страницы категории. 
[not-dle-filter page-cat] текст [/not-dle-filter]
 Выведет текст внутри тегов если нет данных категории со страницы категории. 
[dle-filter cat.id=33] текст [/dle-filter]
 Выведет текст внутри тегов если ID категории, со страницы категории, равно 33. 
[dle-filter cat.name=Информация] текст [/dle-filter]
 Выведет текст внутри тегов если название категории, со страницы категории, равно Информация. 
[dle-filter ...] текст [elif ...] текст [/elif][else] текст [/dle-filter]
 Поддержка условий elif и else. 
[dle-filter extra-page] текст [/dle-filter]
 Выведет текст внутри тегов на любой дополнительной странице. 
[not-dle-filter extra-page] текст [/not-dle-filter]
 Выведет текст внутри тегов на странице фильтра если это не дополнительная страница. 
{dle-filter r.date.from date=X}
 Выводит дату со слайдера по поиску даты добавления новости ОТ в заданном в теге формате. Тем самым вы можете выводить не только дату полностью, но и ее отдельные части. Формат даты задается согласно формату принятому в PHP. Например, тег {date=d} выведет день месяца, а тег {date=F} выведет название месяца, а тег {date=d-m-Y} выведет день месяц и год. 
{dle-filter r.date.to date=X}
 Выводит дату со слайдера по поиску даты добавления новости ДО в заданном в теге формате. Тем самым вы можете выводить не только дату полностью, но и ее отдельные части. Формат даты задается согласно формату принятому в PHP. Например, тег {date=d} выведет день месяца, а тег {date=F} выведет название месяца, а тег {date=d-m-Y} выведет день месяц и год. 
{dle-filter r.edit.from date=X}
 Выводит дату со слайдера по поиску даты редактирования новости ОТ в заданном в теге формате. Тем самым вы можете выводить не только дату полностью, но и ее отдельные части. Формат даты задается согласно формату принятому в PHP. Например, тег {date=d} выведет день месяца, а тег {date=F} выведет название месяца, а тег {date=d-m-Y} выведет день месяц и год. 
{dle-filter r.edit.to date=X}
 Выводит дату со слайдера по поиску даты редактирования новости ОТ в заданном в теге формате. Тем самым вы можете выводить не только дату полностью, но и ее отдельные части. Формат даты задается согласно формату принятому в PHP. Например, тег {date=d} выведет день месяца, а тег {date=F} выведет название месяца, а тег {date=d-m-Y} выведет день месяц и год. 
[dle-filter declination={dle-filter count-news}]новост|ь|и|ей[/declination]
 Выведет склоненное слово. Вместо тега {dle-filter count-news} может быть любой другой который содержит только целое число.
Тег Описание 
{dle-filter h1}
 Выведет Заголовок H1 страницы. 
[dle-filter h1] текст [/dle-filter]
 Выведет текст внутри тегов если Заголовок H1 был заполнен. 
[not-dle-filter h1] текст [/not-dle-filter]
 Выведет текст внутри тегов если Заголовок H1 не был заполнен. 
{dle-filter description}
 Выведет SEO текст страницы. 
[dle-filter description] текст [/dle-filter]
 Выведет текст внутри тегов если SEO текст был заполнен. 
[not-dle-filter description] текст [/not-dle-filter]
 Выведет текст внутри тегов если SEO текст не был заполнен.

Скрытие и показ блоков в зависимости от выбранного значения

Для того что бы скрыть элемент нужно прописать к нужному блоку data-dlefilter-hide="NAME", где NAME название параметра скрываемого элемента формы.

Для того что бы после выбора нужного значения показывало скрытый блок нужно прописать data-dlefilter-show="NAME:value,value2" для нужного элемента формы, где NAME название параметра скрываемого элемента формы, а value и value2 это при каких значениях показывать блок.

Вы можете указывать несколько скрываемых блоков через точку с запятой. Наглядней в примере.

Посмотреть пример

Вывод контента в нужное место

По умолчанию при AJAX подгрузке новостей модуль выводит их в стандартном теге <div id="dle-content">, если вам нужно изменить вывод в другое место, в теге
<form data-dlefilter="dle-filter">
Пропишите параметр data-dlefilter-id="X", где X это ваш ID элемента в который нужно произвести вывод контента при AJAX подгрузке фильтра.

Частые ошибки

Выставьте права 666 или 777, в зависимости от настроек вашего сервера, на файл /engine/lazydev/dle_filter/data/config.php

Выставьте права 666 или 777, в зависимости от настроек вашего сервера, на файл /engine/lazydev/dle_filter/data/fields.php

Выставьте права 666 или 777, в зависимости от настроек вашего сервера, на файл /engine/lazydev/dle_filter/data/pages.php

В данном случае нужно обратиться к технической поддержке хостинга и попросить выдать пользователю базы данных права на полное управление триггерами.

Кнопки для «Поиска»‎ и «Сброса»‎ не обязательны, в настройках модуля вы можете включить автоматический поиск после выбора данных.

Для текстового поля не обязательно задавать значение, лишь в том случае если нужно чтобы оно было поумолчанию.