Введение

Атрибуты - сущность, позволяющая настраивать структуру вашего приложения. С их помощью вы можете добиться максимальной гибкости и избавиться от хардкода.

Наборы атрибутов похожи на коллекцию свойств, значениями которых вы можете управлять через панель администратора. Они отличаются по типу привязки к различным сущностям. Подробнее о типах можно прочитать в разделе "Типы".

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

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

Структура

Каждый набор атрибутов содержит настраиваемую коллекцию атрибутов, которые хранят контент вашего проекта. Этими атрибутами вы можете управлять из системы управления. Это удобно, так как у вас больше нет необходимости редактировать код приложения, чтобы изменять ваш проект. Просто вынесете все контентные составляющие, которые могут быть изменены, в атрибуты.

Маркеры

Маркеры не могут содержать пробелы и начинаться с цифры. При попытке ввести некорректные значения в поле маркера система проигнорирует ввод.

Имя

Чтобы вам было удобнее ориентироваться, каждый атрибут имеет обязательный параметр имени, который является не уникальный строкой. Именуйте атрибуты таким образом, чтобы вам было удобно с ними работать.

Маркер

В качестве идентификатора каждый атрибут обладает обязательным параметром - "маркер", который является уникальной строкой. Маркер также используется в качестве ключа для доступа к атрибутам в коде вашего проекта. Имейте это ввиду при задании маркера атрибута, чтобы не столкнуться с конфликтами синтаксиса.

Тип данных

Выберете тип данных для каждого поля атрибута, которое оно будет хранить.

Типы данных могут быть следующего типа:

• String: Простой текст, например, "Привет, мир!".
• Text: Более длинный текст, часто с форматом, например, статья или письмо.
• Text with Header: Текст с заголовком, который может быть использован для обозначения темы или категории.
• Integer: Целое число, например, 5, 100, -2.e
• Float: Тип данных для чисел с плавающей запятой, которые могут иметь десятичную часть, например 3.14, 1.5, -0.25
• Real: То же, что и Float, но с более высокой точностью.
• Date and Time: Сочетание даты и времени, например, 2023-10-27 10:00:00.
• Date: Дата, например, 2023-10-27.
• Time: Время, например, 10:00:00.
• File: Любой файл на вашем компьютере, например, документ, изображение, музыка.
• Image: Изображение, например, фотография, рисунок.
• Group of Images: Коллекция изображений, например, альбом фотографий.
• Radio Button: Кнопка выбора, из которой можно выбрать только один вариант.
• List: Список элементов, например, список покупок.
• Entity: Сущность, представляющая объект из реального мира, например, человек, место, организация.

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

Возможности

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

Атрибуты

Если один набор атрибутов используется сразу несколькими сущностями, нужно быть внимательным при изменении атрибутов этого набора. Так, если вы удалите один из атрибутов, то этот атрибут будет удален везде, где используется этот атрибут вместе с контентом. Если же вы добавите новый атрибут в набор, то этот атрибут также будет добавлен везде, где этот набор атрибутов используется.