Общий синтаксис указания свойства страницы выглядит следующим образом:
@@property=value
В этом случае название свойства будет property
, а его значение — value
.
Если свойство может содержать несколько значений, то можно использовать следующую конструкцию:
@@property[]=value1 @@property[]=value2
В приведенном выше примере значением свойства property
будет массив, состоящий из двух значений — value1
и value2
.
При использовании собственных свойств рекомендуется добавлять к их названию знак подчеркивания, чтобы избежать возможных проблем при добавлении такого же свойства в будущих версиях движка.
Ниже представлен список используемых в движке свойств и их описание:
- @@title
Заголовок браузера. Обязательное свойство страницы.
Замечание Для парсера для задания заголовка браузера используются символы решетки.
- @@h1
Название страницы.
Замечание Если не указано название страницы, то будет использован заголовок браузера.
- @@menu
Название пункта меню для данной страницы.
Замечание Если не указано название пункта меню, то будет использовано название страницы.
- @@keywords
Ключевые слова страницы. Выводятся в мета-тэгах.
- @@description
Описание страницы. Выводится в мета-тэгах.
- @@template
Название шаблона, который будет использован для оформления страницы. Название шаблона задается без расширения файла.
@@template=default
- @@template.zhtml
Название части шаблона, которая будет подключаться при вызове для страницы функции z_html(). Название части задается без расширения файла.
@@template.zhtml=simplepage
- @@time
POSIX-время публикации страницы. Страница будет доступна только после наступления этого времени.
Замечание Если у страницы это время не задано, но указано свойство
@@publish
, то значение свойства@@publish
будет преобразовано в POSIX-время согласно временной зоне, заданой в настройках сайта.При отсутствии
@@time
и@@publish
будет использовано время последней модификации файла с описанием страницы.- @@publish
Дата публикации страницы в формате ГГГГ-ММ-ДД ЧЧ:ММ:СС с учетом временной зоны, заданной в настройках сайта.
@@publish=2009-07-13
Замечание Если у страницы прописано свойство
@@time
, то свойство@@publish
будет проигнорировано сайтом и перезаписано с учетом временной зоны, заданной в настройках сайта.- @@last-modified
Дата последнего редактирования страницы в формате ГГГГ-ММ-ДД ЧЧ:ММ:СС.
@@last-modified=2011-08-01
При публикации из Zebrum CMS дата последнего редактирования страницы подставляется автоматически.
Вы можете настроить вывод даты последнего редактирования страницы (для поисковых систем) в коде шаблона. Для этого добавьте между тэгами
<head></head>
код:<meta http-equiv="Last-Modified" content="<?php echo date(DATE_RFC1123, zengine::template()->getPage()->getEditTime()); ?>">
- @@sort
Номер сортировки страницы. Может быть использовано для сортировки пунктов меню.
Замечание При наполнении сайта с помощью парсера значение свойства будет соответствовать порядковому номеру страницы в тексте.
- @@tags
Список тэгов страницу через запятую.
- @@menuid
Код меню, в котором будет выводиться ссылка на эту страницу.
Замечание Если код меню не указан, то будет использован код меню родительской страницы, а для страницы первого уровня — «main».
- @@nosubmenu
Запрещает выводить подпункты меню у текущей страницы. Пункт меню текущей страницы выводится.
@@nosubmenu=1
- @@nomenuitem
Запрещает выводить пункт меню текущей страницы.
@@nomenuitem=1
- @@menuorder
Порядок сортировки дочерних страниц в меню.
Замечание Если порядок сортировки не указан, то будет использован порядок, заданный в настройках сайта.
Для того, чтобы вывести в меню дочерние страницы в обратном хронологическом порядке, можно использовать следующее правило:
@@menuorder=time desc, sort desc
- @@module
Название класса модуля, который будет отвечать за формирование текста страницы.
Параметры модуля зависят от модуля, задаются как свойства страницы.
@@module=zmodule_sitemap @@param.subpage=p.
- @@param.*
Настройки модуля страницы задаются свойствами, названия которых начинаются с
param
.@@module=zmodule_listpages @@param.template=mylistpages.php @@param.perpage=5
- @@donotlist
При указании этого свойства страница не будет участвовать в классификаторе
ztaxonomy_time
и, соответственно, не появится в списке страниц модуляzmodule_allpages
и в виджетеzwidget_recentpages
.@@donotlist=1
- @@split, @@nosplit
В зависимости от настроек автоматического деления текста страницы на части (подстраницы) используются разные свойства.
При включенном автоматическом делении используется свойство
@@nosplit
для запрета разбиения текста страницы на подстраницы.@@nosplit=1
При выключенном —
@@split
для разрешения разбиения текста.@@split=1
- @@filter
Данное свойство используется для указания преобразований, которые необходимо проделать с текстом перед выводом в браузер.
Эти преобразования можно перечислять через запятую.
В качестве стандартных преобразований в дистрибутив Zebrum Lite входят:
zfilter_asis
— выводит текст «как есть»;zfilter_text2html
— преобразует обычный текст в HTML;zfilter_php
— интерпретирует текст как PHP-код.
@@filter=zfilter_php, zfilter_text2html
Замечание Если для страницы не указано данное свойство, то используетсся значение, заданное в настройках сайта.
- @@charset
Кодировка файла с информацией о странице.
Замечание Если для страницы не указана кодировка, то используется значениеи из настроек сайта.
При наполнении сайта с помощью парсера значение свойства будет прописано согласно настройкам парсера.
Замечание Если кодировка с информацией о странице будет отличаться от кодировки сайта, то информация будет автоматически перекодирована перед использованием на сайте.
- @@images
Название файла с изображением, которое будет добавлено в начало страницы.
Предполагается, что файл с изображением находится в папке
images
.@@images=zebrum.png
Более детальную информацию по свойству
@@images
можно почитать здесь.