2.2. Свойства страницы

Общий синтаксис указания свойства страницы выглядит следующим образом:

@@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 можно почитать здесь.