Справка. Компоновка контента.
Для записей могут быть применены различные макеты, а так же, запись может быть независимой и не содержать макета.
Все макеты должны находиться в каталоге: Themes/{название темы}/partials/
Ресурсы темы (скрипты, стили, изображения и т.д.) должны находиться в каталоге: wwwroot/themes/{название темы}
Для параметра Layout
могут быть применены следующие значения:
пустая_строка
- при пустом значении будет применяться макет по умолчанию _layout.html
null
- данный параметр следует указывать для самодостаточной страницы и макет не будет применяться для данной страницы_layout2
- к странице будет применён макет _layout2.html
Макет должен обязательно содержать: {body}
. В указанное место будет помещён контент страницы.
Весь контент может быть разбит на частичные представления. Например: отдельные частичные представления для скриптов, панели навигации и так далее. Это может быть удобно для многократного применения в макете повторяющегося кода.
Все частичные представления должны находиться в каталоге: Themes/{название темы}/partials/
Частичные представления можно применять как в макете Layout
, так и в контенте страницы
Для вставки содержимого частичного представления необходимо в нужном месте указать: {partial namePartial}
.
Где namePartial
- это название файла частичного представления, находящегося в каталоге partials
.
Файлы частичных представлений должны иметь расширение .html
Пример: {partial head}
- данный код будет заменён контентом, который содержится в файле: head.html
Контент на странице и макете можно отображать в зависимости от роли пользователя. Примеры:
<notauthorized></notauthorized>
- код, заключённый в данные теги будет доступен только анонимным пользователям <authorize></authorize>
- код, заключённый в данные теги будет доступен только авторизованным пользователям <authorize-author></authorize-author>
- код, заключённый в данные теги будет доступен только авторам<authorize-moderator></authorize-moderator>
- код, заключённый в данные теги будет доступен только модераторам<authorize-admin></authorize-admin>
- код, заключённый в данные теги будет доступен только администраторамДля страниц возможна подстановка значений и параметров сохраненных в БД:
{postid}
- идентификатор записи{posttitle}
- заголовок{postdescription}
- описание{posturl}
- относительный URL{postdatecreate}
- дата создания записи{postdatelastmodified}
- дата последнего редактирования{posttags}
- теги записи{postviews}
- количество просмотров записи{postimageurl}
- относительный URL к изображению{postcontent}
- контент записиВ макете и странице возможна подстановка глобальных настроек приложения, содержащихся в файле: settings.xml
В целях безопасности происходит замена только публичных настроек (itspublic="true")
Для подмены достаточно указать в коде: {set setting.Key}
, где setting.Key
- уникальный ключ настройки.