Наборы данных — это механизм, который позволяет создавать дополнительные шаблоны вывода списка записей для конкретного типа контента.
Каждый набор определяет:
фильтры, по которым выбираются записи,
способ сортировки,
количество элементов,
шаблон отображения,
особенности поведения и ограничений.
Наборы используются для создания различных страниц и блоков:
например, «популярные записи», «новые статьи», «события на следующей неделе», «топ авторов» и т. д.
Документация предназначена для администраторов и разработчиков, которые настраивают логику вывода контента на сайте.
Общая логика системы
Набор — это сохранённая конфигурация выборки данных.
Каждый набор работает только внутри своего типа контента.
Наборы используются в меню, в шаблонах, в виджетах, на отдельных страницах — везде, где нужно вывести список записей по определённым правилам.
Один тип контента может иметь любое количество наборов.
Для набора не требуются дополнительные поля в БД — он использует структуру типа контента.
Создание нового набора
При создании набора доступны следующие группы настроек:
1. Общие настройки
Название
Отображается в админ-панели, в списке наборов и при выборе набора в меню или виджетах.
Системное имя
Уникальный идентификатор набора.
Используется в шаблонах и внутренней логике.
Допускаются латинские буквы и цифры.
Описание
Необязательное поле для внутреннего комментария, не отображается пользователям.
2. Настройки фильтрации
Набор позволяет настроить условия, по которым в него будут попадать записи:
Фильтры по полям
Можно указать:
условие сравнения,
несколько условий одновременно.
Это позволяют создавать выборки:
«только опубликованные»...
Фильтр по дате
Например:
записи за последнюю неделю,
записи за сегодня,
записи начиная с указанной даты.
3. Настройки сортировки
Можно задать порядок, в котором записи будут отображаться:
по дате публикации (свежее/старее),
по количеству просмотров,
по пользовательскому полю.
4. Количество записей
Можно задать:
конкретное количество элементов,
Этот параметр используется:
на страницах категории,
5. Настройки отображения
Шаблон списка
Можно выбрать шаблон, по которому записи будут отображаться:
стандартный список,
компактный список,
6. Пагинация
Для наборов можно активировать или отключить пагинацию:
если включена — выводится стандартная постраничная навигация,
если отключена — выводится только фиксированное количество записей.
7. Доступ и приватность
Набор учитывает все правила доступа, заданные у типа контента:
если пользователь не может видеть запись, она не попадёт в набор,
приватные записи не выводятся,
доступ можно ограничить по группам пользователей.
Использование наборов
1. В меню
Набор можно выбрать как источник данных для пункта меню.
Это создаёт страницу по адресу, соответствующему пункту меню.
2. В виджетах
Набор можно использовать для формирования:
«топ-записей»,
«новостей недели»...
Управление наборами
Редактирование
Все параметры набора можно изменить в любой момент — это сразу влияет на вывод.
Удаление
Удаление набора не влияет на сами записи — только на возможность их вывода через набор.
Рекомендации по использованию
Создавайте отдельные наборы для разных сценариев (новые, популярные, подборки).
Не перегружайте набор большим количеством условий — это влияет на производительность.
Не используйте наборы как замену категориям — они решают разные задачи.
Используйте наборы для блока «рекомендуемое», комбинируя фильтры и сортировку.
В шаблонах выбирайте минимально достаточный объём данных.
Глоссарий
Набор (Dataset) — сохранённая конфигурация выборки записей типа контента.
Фильтр — условие, по которому выбираются записи.
Сортировка — порядок, в котором отображаются записи.
Шаблон списка — внешний вид вывода элементов набора.
Пагинация — механизм постраничной навигации.
Источник данных для меню — способ создать страницу с контентом на базе набора.