Сущности в системе управления ygin называются Объекты. Для того, чтобы сохранять простейшие табличные данные, необходимо создать объект и его Свойства.

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

Для того чтобы создать свой объект, пользователю необходимо иметь роль разработчика. В случае наличия необходимых прав, ему будет доступен пункт меню Разработка → Объекты в системе управления.

Меню Объекты

В системе управления ygin существует условность: на основе структуры вложенности объектов формируется меню на бэкенде. При этом некоторые объекты создаются исключительно для создания папок в иерархической структуре, а не для хранения экземпляров. В то же время, существует возможность создать объекты, которые будут и хранить экземпляры, и содержать вложенные объекты.

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

Рассмотрим характеристики, которые необходимо заполнить для создания полноценного объекта на примере Меню.

  • id — уникальный идентификатор объекта в виде строки на латинице. Например, "ygin-menu", где ygin можно заменить на название вашего проекта, чтобы обеспечить уникальность идентификаторов.
  • Имя объекта — название объекта на человекопонятном языке.
  • Тип объекта — определяет способы хранения данных. В случае простого сохранения данных в таблице применяется "Стандартный" тип объекта. Также доступны типы "Контроллер" и "Ссылка". Тип "Контроллер" применяется для создания своего специфического контроллера. Тип "Ссылка" позволяет задать ссылку, например на систему статистики сайта.
  • Таблица/Контроллер/Ссылка — определяет имя таблицы в базе данных для хранения экземпляров объекта, в случае Стандартного типа. Таблица в базе данных будет создана автоматически. Для типа Контроллер необходимо задать маршрут контроллера, класс контроллера должен быть унаследован от класса DaBackendController. Для типа Ссылка необходимо задать ссылку, на которую будет ссылать объект в меню.
  • Путь к документам — путь на сервере относительно корня сайта, по которому будут храниться файлы, прикрепляемые к экземплярам объекта. Например, "content/menu". Папки прикладных объектов для хранения файлов принято указывать в папке "/content". Создание папок происходит автоматически и с нужными правами.
  • Свойство модели для отображения — свойство модели объекта, значение которого будет использоваться для выбора экземпляра этого объекта в связанных объектах. Например, для выбора Категории новости в Новости будет использоваться свойство модели "name" у объекта Категория новостей, т.е. имя категории.
  • Свойство для порядка — по умолчанию экземпляры объекта будут упорядочены по этому свойству. Например, Новости логично упорядочивать по дате.
  • Тип порядка — определяет направление упорядочивания по Свойству для порядка. Например, Новости обычно упорядочивают так, чтобы последние оказывались наверху, т.е. DESC.
  • Yii-модель — имя модели Yii. Например, ygin.models.File или просто Menu, если есть понимание, что приложение уже знает путь к модели.
  • Права доступа — блок позволяет сразу разрать нужные права для различных ролей в системе.

Дополнительные характеристики объекта:

  • Родитель — имя объекта, в который вложен создаваемый нами объект. Существует возможность выбрать другой объект в качестве родительского для перемещения объекта по иерархии и формирования правильной структуры меню на бэкенде.
  • Создать представление — механизм автоматического создания представления объекта в системе управления на основе сведений об объекте и его свойствах модели.

Процесс создания свойств объекта рассмотрен подробнее в статье Создание свойств объекта.

Для отображения объекта в системе управления ygin в меню, необходимо наличие представления у этого объекта. Этот процесс рассматривается в отдельной статье Создание представлений объекта.

27 июня 2013

Автор: Огнёв Иван

Комментарии (0)

Добавить комментарий