Определение контента
Перед тем как контент будет создан он должен быть определен. По этой причине, когда первый раз открывается чистая установка Umbraco, нет возможности создавать контент в секции контента. Необходимо вначале описать тип контента. Контент определяется с помощью типа документа, где описано, какие данные могут быть сохранены в узле данного контента, какие редакторы используются, как он организован, где в структуре сайта можно его использовать и так далее.
Что такое тип документа?
В самом первом приближении тип документа это форма, содержащая набор полей или закладок, где можно определить правила о том, где данный контент может быть создан, какой шаблон или шаблоны допустимы, иконку типа документа и так далее.
Тип документа может определять целую страницу или более ограниченный контент, который может быть многократно использован в других узлах, например, SEO компоненты. Имеется возможность в полной мере управлять, какой контент и где может быть создан.
Свойства
Каждое поле типа документа называется свойством. У каждого свойства имеется название, псевдоним (используется для отображения содержимого свойства в шаблоне) и редактор. Редактор определяет, какой тип данных содержится в свойстве и какой используется метод ввода. Существует много редакторов доступных для поля ввода (textstring, Rich text, media picker и так далее), кроме того имеется возможность настраивать существующие и добавлять дополнительные редакторы.
Некоторые редакторы требуют настройки, настроенный редактор сохраняется как тип данных и может быть многократно использован для многих свойств или типов документов. Это настраивается в разделе типов данных секции разработчика.
Cоздание типа документа
Тип документа создается в секции настройки с помощью редактора типов документов.
Перейдите в секцию Settings бэк-офиса. В узле Document Types нажмите на иконку меню (•••) чтобы открыть контекстное меню. Далее выберите Document Type. Таким образом создастся новый тип документа с шаблоном (может быть найден в Templates в секции Settings), который будет являться шаблоном по умолчанию для типа документа.
Также можно выбрать создание типа документа без шаблона или создать директорию для организации типов документов.Определение корневого узла
Для начала укажем название типа документа. Данный тип документа будет корневым узлом для контента, назовем его "Home".
Обратите внимание, что псевдоним типа документа автоматически генерируется основываясь на название. Если необходимо поменять псевдоним, нужно нажать на иконку замка.
Для установки иконки типа документа нажмите на иконку в верхнем левом углу. Откроется окно выбора иконок. Найдите и установите нужную иконку. Эта иконка будет использоваться в дереве контента, выбор подходящей иконки это хороший способ для наглядного отображения дерева контента.
Перейдите в закладку Permissions и установите галочку Yes - allow content of this type in the root, затем сохраните тип документа нажатием кнопки сохранения в нижнем правом углу.
Создание корневого узла
Теперь перейдите в секцию Content, нажмите на иконку меню напротив Content и выберите тип документа Home. Назовите его "Home" и нажмите кнопку Save and Publish.
Так как не были созданы собственные свойства, все что можно увидеть в узле "Home" это закладка Properties, которая содержит свойства по умолчанию, имеющиеся для любого контента в Umbraco.
Добавим несколько свойств.
Закладки и свойства
Перейдите в секцию Settings, разверните Document Types и выберите тип документа Home.
Добавление закладок
Перед тем как начать добавлять свойства в тип документа необходимо создать закладку для хранения свойств.
Нажмите Add new tab и назовите закладку "Content".
Если у вас имеется несколько закладок их можно отсортировать перетаскиванием или установив числовой порядок сортировки. Это делается нажатием Reorder.Добавление свойств
После добавления закладки можно начать добавлять свойства. Добавим Rich Text editor на закладку Content.
Нажмите Add property на закладке Content tab. Откроется диалог настройки свойства. Здесь можно установить метаданные для каждого свойства (название, псевдоним, описание), выбрать какой редактор типа использовать и при необходимости добавить валидацию.
Назовите свойство, название будет отображаться администратору, поэтому сделайте его понятным. Имейте в виду, что псевдоним генерируется автоматический. Назовем свойство "Body Text".
Редакторы свойств
Нажатие Add editor откроет окно выбора редактора. Здесь есть возможность выбрать из имеющихся редакторов Available editors (при этом создается новая конфигурация) или использовать уже настроенные редакторы Reuse. Чтобы легко найти нужный редактор можно воспользоваться фильтром написав "Rich". С помощью фильтрации вначале отобразятся настроенные редакторы (под Reuse), а затем все остальные.
Выберите Rich Text editor в доступных редакторах.
Это позволит сконфигурировать настройки редактора Rich Text editor для данного свойства. Обратите внимание, что название редактора (Home - Body Text - Rich Text editor) основано на названии типа документа, названии свойства и названии редактора свойства. Переименуем его в "Simple Rich Text editor" и выберем самые необходимые опции.
- bold
- italic
- alignLeft
- alignCenter
- link
- umbMediaPicker
Далее нажмите Submit.
Если установлена галочка Mandatory, свойство становится обязательным и контент не может быть сохранён, если не указано значение для свойства (в Richtext editor в данном случае). Можно установить дополнительную проверку, добавив регулярное выражение в поле Validation.
Сохраните свойство и тип документа. Если перейти в секцию Content и нажать на узле Home, то появится закладка Content со свойством Body Text.
Определение дочерних узлов
Далее создадим тип документа с простым текстом, который будет использоваться как дочерние страницы на сайте.
Перейдите обратно в секцию Settings и создайте новый тип документа, назовите его "Text Page". Добавьте закладку с названием "Content", и далее добавим два свойства. Первое свойство с названием "Summary" и редактором свойства Textarea и второе свойство с названием "Body Text" и переиспользуемым типом данных Simple Rich Text Editor.
Cоздание дочерних узлов
Перед тем как создавать Text Page в секции Content, необходимо настроить, чтобы тип документа Text Page мог быть создано как дочерний узел для узла Home. Выберите тип документа Home и перейдите на закладку Permissions. Нажмите Add child и выберите Text Page.
Перейдите в секцию Content и нажмите на иконку меню (•••) напротив узла Home и выберите тип документа Text page. Назовите страницу "About us". Получилась очень простая структура контента.
Типы документов очень широко настраивается и могут быть использованы множеством способов, начиная от определения переиспользуемых частей контента и целых страниц до использования в качестве контейнера или репозитория.