Cистема управления сайтом

Служебные поля

Все служебные поля начинаются со знака подчёркивания. Они присутствуют у каждого документа в системе. Поведение системы зависит от значений служебных полей. Изменение одного из этих полей приводит к изменению поведения системы. На основании данных служебных полей можно ориентироваться по событиям, которые происходили с документом.

Список служебных полей:

Название поля

Описание

Возможность записи
из DJEM-скрипта

_id

Идентификатор документа – уникальное цифровое значение для каждого документа и раздела. Значение его используется всегда, когда нужно обратиться к полям конкретного документа или раздела. Это самое важное поле документа, с помощью него документы ссылаются друг на друга, а пользователь (DJEM-скрипт) запрашивает документ у системы с помощью оператора прямого доступа <[id].field>.

нет

_name

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

есть

_type

ID типа документа, который определяет все выходные параметры документа. См. пункт  Типы документов

есть

_image

Иконка документа

есть

_default_subtype

Тип поддокумента по умолчанию

есть

_sort

Значение документа, используемое для сортировки документов при выводе. Из скрипта это значение изменить нельзя. Можно изменить значение _sort, передвигая документы в клиентской оболочке с помощью комбинации клавиш <Ctrl> +<UP> и <Ctrl> + <Down>.

нет

_code

Условный код раздела. Используется как имя директории в файловых системах, для формирования пути к документам и для формирования внутреннего пути к документу – _path.

нет

_path

Путь к документу, формируемый из полей _code. Например, код родительского раздела системы – main, код подкаталога первого уровня – menu, в подкаталоге menu находится каталог news. Путь до каталога news будет: main.menu.news. При выборке документов часто используются имена для указания пути. Например, с помощью оператора foreach требуется получить доступ к документам-новостям, находящимся внутри подкаталога news, то используйте путь main.menu.news.$.

нет

_codepage

Кодировка документа – одна из разрешенных в системе кодировок. Доступны для выбора следующие кодировки: utf-8, koi8−r и windows-1251. По умолчанию документ выводится в кодировке utf-8.

есть

_url

url-ссылка документа

есть

_file

Имя файла от html-корня сайта, куда публикуется документ. Обычно, значение этого поля совпадает со значением поля _url, за редкими исключениями – например, документ является «документом-ссылкой», когда на сервере его нет в виде файла. Он является пунктом в меню и указывает на другие документы.

есть

_parent_id

Идентификатор родительского раздела документа. Ссылается на поле _id документа, содержащего данный документ.

есть

_create_time

Время создания документа. Выдается в виде стандартного для UNIX-систем timestamp и представляется количеством секунд, прошедших с 1 января 1970 года. Значение можно обработать методом time для получения удобочитаемого выражения времени.

нет

_modify_time

Время последней модификации документа. Задаётся в виде UNIX-timestamp

нет

_publish_time

Время первой публикации документа – выдается в виде UNIX timestamp. До момента первой публикации документа равняется нулю. После первой публикации устанавливается и сохраняется неизменным при всех последующих публикациях.

есть

_last_publish_time

Время последней публикации документа. Устанавливается при каждой публикации документа.

нет

_link1, _link2, _link3

Поля для «привязки» документов. Рекомендуется использовать в «связях»

Каждое из этих полей может содержать одно числовое значение. Обычно это ID «привязанного документа». 

есть

_status

Статус документа. Содержит числовой код статуса, созданного пользователем в папке «Статусы». Статус документа может изменяться:

вручную пользователем, используя пункт контекстного меню «Изменить статус»;

автоматически, при условии, что раздел, содержащий документ имеет назначенную ему «ролевую карту».

нет

_ctpl_id

Идентификатор контент-шаблона документа. Если его значение равно 0, то документ использует собственный контент-шаблон.

есть

_dtpl_id

Идентификатор дизайн-шаблона документа. Если его значение равно 0, то документ использует собственный дизайн-шаблон.

есть

_dtpl

Собственный дизайн-шаблон документа. Чтобы получить дизайн-шаблон для текущего документа, необходимо запросить поле _dtpl у того документа, на который сылается поле _dtpl_id. Если _dtpl_id равен 0, то используется собственный дизайн-шаблон.

нет

_creator_id

Идентификатор пользователя, создавшего документ.

нет

_level

Уровень вложенности документа в дереве документов. Корневой документ имеет уровень вложенности 0.

нет

_grid_where

Содержит условия фильтрации документов, если раздел является метапапкой. Это поле можно использовать в дизайн-шаблоне при выводе, для того, чтобы скопировать условия метапапки. Например,  <foreach name=x where=<#_grid_where#>>

нет

_grid_path

Содержит путь к документам, отображаемым в данном разделе. Как и поле _grid_where, может быть использовано для вывода документов мета-папки.

нет

Поиск по документации

О компании  |  Партнёрам

© 2005 — 2024 DJEM Solutions, все права защищены. | Дизайн — Студия Fractalla