Поля контента — это элементы структуры данных, которые формируют содержимое записей внутри типа контента. Каждый тип контента имеет собственный набор полей, который определяет, какая информация будет храниться, как она вводится пользователем и каким образом отображается на сайте.
Документация предназначена для администраторов, разработчиков и редакторов, которые настраивают структуру типов контента и управляют их полями.
Общая логика системы
Система поддерживает базовые системные поля, которые создаются автоматически для каждого типа контента. Эти поля являются фундаментальными и не могут быть удалены:
Название
Дата публикации
Автор
Описание
Эти поля можно переименовывать и настраивать, но нельзя исключить из структуры.
Дополнительно администратор может создавать любое количество собственных полей разных типов. Каждое поле имеет уникальные настройки, которые определяют его логику и отображение.
Функциональность: управление полями
Создание нового поля
При добавлении нового поля задаются:
1. Системное имя
Уникальный идентификатор поля.
Используется системой для хранения данных.
Допускает только латинские буквы и цифры.
Не должно совпадать с системными именами.
Длина имени — до 40 символов.
2. Название
Отображается пользователю в форме редактирования.
Может отличаться от системного имени.
3. Подсказка
Помогает пользователю понять назначение поля.
Показывается рядом с полем при редактировании записи.
4. Тип поля
Тип определяет:
формат ввода,
тип хранимых данных,
правила отображения.
Доступные категории типов полей включают:
Текстовые поля
Многострочные текстовые поля
Поля с HTML-редактором
Поля выбора (список, радиокнопки, галочки)
Дата/дата-время
Числовые поля
Изображения
Файлы
Логические флаги
Ссылки
Каждый тип поля имеет собственные дополнительные настройки.
Настройки отображения и поведения
Отображение в списке записей
Поле можно включить или отключить на странице списка:
Оно может отображаться как колонка в списке записей.
Можно выбрать порядок, оформление и заголовок.
Отображение внутри записи
Поле можно отображать:
внутри основного контента записи,
внутри групп полей,
в произвольном месте шаблона.
Можно настроить:
порядок отображения,
формат вывода,
заголовок при выводе,
стиль.
Группы полей
Поля могут объединяться в группы.
Группы помогают:
логически структурировать множество полей,
улучшать понимание интерфейса редактирования,
показывать данные пользователю более организованно.
Группы могут быть:
разворачиваемыми/сворачиваемыми,
с собственным заголовком,
расположенными в определённом порядке.
Значения по умолчанию
Для поля можно указать:
статическое значение по умолчанию,
значение из профиля пользователя.
Это используется, если:
нужно ускорить заполнение,
часть данных повторяется,
записи должны иметь заранее заполненные параметры.
Права доступа на поле
Можно определить:
кто может просматривать поле,
кто может редактировать поле,
доступно ли поле только автору,
скрывать ли поле от гостей,
доступны ли фильтры по этому полю.
Это важно для:
защиты приватных данных,
разграничения функционала между авторами и модераторами,
настройки отображения в зависимости от роли пользователя.
Управление полями
Порядок полей
Порядок можно менять перетаскиванием. После сохранения он используется:
в форме редактирования,
в шаблоне просмотра записи,
в группировке полей.
Редактирование
Каждое пользовательское поле можно:
редактировать,
деактивировать,
переместить,
удалить (кроме системных).
Удаление
Удалить можно только пользовательские поля.
Удаление поля приводит к удалению всех связанных данных.
Типы полей (концептуальное описание)
Ниже приведён набор типов, аналогичных оригинальной системе:
Строковое поле
Используется для коротких текстовых значений.
Многострочное поле
Используется для больших текстов.
HTML-редактор
Позволяет создавать форматированный текст.
Числовое поле
Используется для целых или дробных чисел.
Дата/Дата-время
Выбор даты и времени с валидированным форматом.
Список (Select)
Предоставляет выбор одного значения из набора.
Radio/Checkbox
Для выбора одного или нескольких вариантов.
URL-ссылка
Поле для ввода ссылок.
Флаг
Булевый переключатель: «Да/Нет».
Изображение
Позволяет загружать изображение, определять размер и правила обработки.
Файл
Используется для загрузки файлов.
Рекомендации
Уникальность системного имени критически важна.
Группируйте поля для удобства пользователей.
Ограничивайте отображение полей, которые не нужны посетителям.
Учитывайте тип данных при выборе поля — особенно при импорте/экспорте.
Настраивайте права доступа, если поле содержит персональные данные.
Не создавайте слишком много полей — это усложняет интерфейс.
Глоссарий
Поле — элемент структуры данных типа контента.
Системное поле — базовое поле, обязательное для всех типов контента.
Пользовательское поле — поле, созданное администратором.
Системное имя — внутренний идентификатор поля.
Группа полей — логический блок полей.
Значение по умолчанию — предустановленное значение при создании записи.
Право доступа — настройки видимости/доступности поля.
Тип поля — определяет формат ввода и тип данных.