Не используется.
Использование лишено смысла. Любое свойство объекта может быть получено по протоколу UObject (см. «Объекты: протокол UObject»). Для этого надо написать имя свойства (значение атрибута name для элемента property) через символ "." (точка) после вызова по протоколу UObject.
Предположим, мы запросили у объекта с id="14" свойство с именем login. Тогда ответ по протоколу UObject будет выглядеть следующим образом:
<udata generation-time="0.001097">
<property id="45" name="login" type="string">
<title>Логин</title>
<value>sv</value>
</property>
</udata>Отобразить это свойство можно, например, так:
<xsl:value-of select="document('uobject://14.login')/udata/property/value" />Используемые шаблоны
Макрос оперирует шаблонами, находящимися в каталоге /tpls/data/.
Используемые блоки шаблона
string
Выводит содержимое для полей типа «Строка».
- %title%
-
Выводит название поля.
- %name%
-
Выводит идентификатор поля.
- %value%
-
Выводит значение поля.
- %template%
-
Выводит текущий шаблон, используемый при выводе свойства для последующего использования во вложенных макросах.
string_empty
Используется в том случае, если необходимо вывести на страницу сообщение о том, что значение поля типа «Строка» пустое.
int
Выводит содержимое для полей типа «Число».
- %title%
-
Выводит название поля.
- %name%
-
Выводит идентификатор поля.
- %value%
-
Выводит значение поля.
- %template%
-
Выводит текущий шаблон, используемый при выводе свойства для последующего использования во вложенных макросах.
int_empty
Используется в том случае, если необходимо вывести на страницу сообщение о том, что значение поля типа «Число» пустое.
float
Выводит содержимое для полей типа «Число с точкой».
- %title%
-
Выводит название поля.
- %name%
-
Выводит идентификатор поля.
- %value%
-
Выводит значение поля.
- %template%
-
Выводит текущий шаблон, используемый при выводе свойства для последующего использования во вложенных макросах.
float_empty
Используется в том случае, если необходимо вывести на страницу сообщение о том, что значение поля типа «Число с точкой» пустое.
price
Выводит содержимое для полей типа «Цена». На данный момент его поведение аналогично блоку int.
- %title%
-
Выводит название поля.
- %name%
-
Выводит идентификатор поля.
- %value%
-
Выводит значение поля
- %template%
-
Выводит текущий шаблон, используемый при выводе свойства для последующего использования во вложенных макросах.
price_empty
Используется в том случае, если необходимо вывести на страницу сообщение о том, что значение поля типа «Цена» пустое.
text
Выводит содержимое для полей типа «Простой текст».
- %title%
-
Выводит название поля.
- %name%
-
Выводит идентификатор поля.
- %value%
-
Выводит значение поля.
- %template%
-
Выводит текущий шаблон, используемый при выводе свойства для последующего использования во вложенных макросах.
text_empty
Используется в том случае, если необходимо вывести на страницу сообщение о том, что значение поля типа «Простой текст» пустое.
date
Выводит содержимое для полей типа «HTML-текст». Его поведение аналогично блоку text.
- %field_id%
-
Выводит числовой идентификатор поля.
- %name%
-
Выводит строковый идентификатор поля.
- %title%
-
Выводит название поля.
- %timestemp%
-
Выводит значение поля в формате timestamp.
- %value%
-
Выводит значение поля в формате YYYY-MM-DD HH:MI:SS.
- %template%
-
Выводит текущий шаблон, используемый при выводе свойства для последующего использования во вложенных макросах.
swf_file
Выводит содержимое для полей типа «Флеш-ролик».
- %title%
-
Выводит название поля.
- %name%
-
Выводит идентификатор поля.
- %value%
-
Выводит значение поля.
- %filename%
-
Имя файла, который содержит выводимое поле.
- %filepath%
-
Путь к файлу в файловой системе (относительный, либо абсолютный).
- %src%
-
Путь к файлу относительно корня сайта. Обычно используется для создания ссылок на файл.
- %size%
-
Размер файла в байтах.
- %ext%
-
Расширение файла («swf»).
- %template%
-
Выводит текущий шаблон, используемый при выводе свойства для последующего использования во вложенных макросах.
- %maxsize%
-
Выводит максимальный размер загружаемого файла (в Мб).
video_file
Выводит содержимое для полей типа «Видео-ролик».
- %title%
-
Выводит название поля.
- %name%
-
Выводит идентификатор поля.
- %value%
-
Выводит значение поля.
- %filename%
-
Имя файла, который содержит выводимое поле.
- %filepath%
-
Путь к файлу в файловой системе (относительный, либо абсолютный).
- %src%
-
Путь к файлу относительно корня сайта. Обычно используется для создания ссылок на файл.
- %size%
-
Размер файла в байтах.
- %ext%
-
Расширение файла.
- %template%
-
Выводит текущий шаблон, используемый при выводе свойства
- %maxsize%
-
Выводит максимальный размер загружаемого файла (в Мб).
wysiwyg
Выводит содержимое для полей типа «HTML-текст». Его поведение аналогично блоку text.
- %title%
-
Выводит название поля.
- %name%
-
Выводит идентификатор поля.
- %value%
-
Выводит значение поля.
- %template%
-
Выводит текущий шаблон, используемый при выводе свойства для последующего использования во вложенных макросах.
wysiwyg_empty
Используется в том случае, если необходимо вывести на страницу сообщение о том, что значение поля типа «HTML-текст» пустое.
file
Выводит содержимое для полей типа «Файл».
- %title%
-
Выводит название поля.
- %name%
-
Выводит идентификатор поля.
- %value%
-
Выводит значение поля.
- %filename%
-
Имя файла, который содержит выводимое поле.
- %filepath%
-
Путь к файлу в файловой системе (относительный, либо абсолютный).
- %src%
-
Путь к файлу относительно корня сайта. Обычно используется для создания ссылок на файл.
- %size%
-
Размер файла в байтах.
- %ext%
-
Расширение файла (например, «exe», «swf»).
- %template%
-
Выводит текущий шаблон, используемый при выводе свойства для последующего использования во вложенных макросах.
- %maxsize%
-
Выводит максимальный размер загружаемого файла (в Мб).
file_empty
Используется в том случае, если необходимо вывести на страницу сообщение о том, что значение поля типа «Файл» пустое.
img_file
Выводит содержимое для полей типа «Изображение».
- %title%
-
Выводит название поля.
- %name%
-
Выводит идентификатор поля.
- %value%
-
Выводит значение поля.
- %filename%
-
Имя файла, который содержит выводимое поле.
- %filepath%
-
Путь к файлу в файловой системе (относительный, либо абсолютный).
- %src%
-
Путь к файлу относительно корня сайта. Обычно используется для создания ссылок на файл.
- %size%
-
Размер файла в байтах
- %ext%
-
Расширение файла (например, «gif», «jpeg», «png»).
- %width%
-
Ширина изображения в пикселях.
- %height%
-
Высота изображения в пикселях.
- %template%
-
Выводит текущий шаблон, используемый при выводе свойства для последующего использования во вложенных макросах.
- %maxsize%
-
Выводит максимальный размер загружаемого файла (в Мб).
img_file_empty
Используется в том случае, если необходимо вывести на страницу сообщение о том, что значение поля типа «Изображение» пустое.
boolean_yes
Этот шаблон используется для полей типа «Кнопка-флажок», которое обозначает значения «да/нет». Если значение поля равно «да» (в редактировании у этого поля стоит галочка, либо каким-либо другим способом оно установлено в значение «true»), то используется этот блок. В противном случае выводится блок boolean_no.
- %title%
-
Выводит название поля.
- %name%
-
Выводит идентификатор поля.
- %template%
-
Выводит текущий шаблон, используемый при выводе свойства для последующего использования во вложенных макросах.
boolean_no
Используется для полей типа «Кнопка-флажок» в том случае, если не выполнено ни одно из условий, позволяющих использовать блок boolean_yes.
- %title%
-
Выводит название поля.
- %name%
-
Выводит идентификатор поля.
- %template%
-
Выводит текущий шаблон, используемый при выводе свойства для последующего использования во вложенных макросах.
relation
Выводит содержимое для полей типа «Выпадающий список», которое содержит выбранный элемент справочника.
- %title%
-
Выводит название поля.
- %name%
-
Выводит идентификатор поля.
- %value%
-
Выводит значение поля (в данном случае — название элемента справочника.
- %object_id%
-
Выводит id объекта, который можно использовать для вывода свойств элемента справочника через макросы %data getPropertyOfObject()% , %data getPropertyGroupOfObject()% или %data getAllGroupsOfObject()%.
- %template%
-
Выводит текущий шаблон, используемый при выводе свойства для последующего использования во вложенных макросах.
relation_empty
Используется в том случае, если необходимо вывести на страницу сообщение о том, что значение поля типа "Выпадающий список" пустое.
relation_mul_block
Блок вывода содержимого для полей типа «Выпадающий список с множественным выбором», которое содержит список выбранных элементов справочника. Требует присутствия блоков relation_mul_item и relation_mul_quant.
- %title%
-
Выводит название поля.
- %name%
-
Выводит идентификатор поля.
- %items%
-
Выводит список значений используя блок relation_mul_item .
- %template%
-
Выводит текущий шаблон, используемый при выводе свойства для последующего использования во вложенных макросах.
relation_mul_item
Выводит отдельное значение для поля типа «Выпадающий список с множественным выбором».
- %value%
-
Выводит значение поля (в данном случае — название элемента справочника
- %object_id%
-
Выводит id объекта, который можно использовать для вывода свойств элемента справочника через макросы %data getPropertyOfObject()%, %data getPropertyGroupOfObject()% или %data getAllGroupsOfObject()%.
- %quant%
-
Позволяет квантификатор (разделитель) между значениями. Использует блок relation_mul_quant .
- %list-class-first%
-
в случае, если элемент первый, выводит "first"
- %list-class-last%
-
в случае, если элемент последний, выводит "last"
- %list-class-odd%
-
в случае, если элемент четный, выводит "odd"
- %list-class-even%
-
в случае, если элемент нечетный, выводит "even"
- %list-position%
-
вставляет порядковый номер в списке
relation_mul_quant
Выводит разделитель для полей типа «Выпадающий список с множественным выбором». Обычно содержит «,» или другой стандартный разделитель.
relation_mul_block_empty
Используется в том случае, если необходимо вывести на страницу сообщение о том, что значение поля типа «Выпадающий список с множественным выбором» пустое.
symlink_block
Блок вывода содержимого для полей типа «Ссылка на дерево», которое содержит список выбранных страниц из дерева сайта. Требует присутствия блоков symlink_item и symlink_quant.
- %title%
-
Выводит название поля.
- %name%
-
Выводит идентификатор поля.
- %items%
-
Выводит список значений, используя блок symlink_item .
- %template%
-
Выводит текущий шаблон, используемый при выводе свойства для последующего использования во вложенных макросах.
symlink_item
Выводит отдельное значение для поля типа «Ссылка на дерево».
- %value%
-
Выводит значение поля (в данном случае — название страницы).
- %link%
-
Выводит ссылку на страницу.
- %id%
-
Выводит id страницы. Можно использовать для вывода свойств страницы через макросы %data.getProperty%, %data.getPropertyGroup% или %data.getAllGroups%.
- %object_id%
-
Выводит id объекта, который является объектом-источником данных для страницы. Можно использовать для вывода свойств страницы через макросы %data getPropertyOfObject()%, %data getPropertyGroupOfObject()% или %data getAllGroupsOfObject()%.
- %quant%
-
Позволяет квантификатор (разделитель) между значениями. Использует блок symlink_quant .
- %list-class-first%
-
в случае, если элемент первый, выводит "first"
- %list-class-last%
-
в случае, если элемент последний, выводит "last"
- %list-class-odd%
-
в случае, если элемент четный, выводит "odd"
- %list-class-even%
-
в случае, если элемент нечетный, выводит "even"
- %list-position%
-
вставляет порядковый номер в списке
symlink_quant
Выводит разделитель для полей типа «Ссылка на дерево». Обычно содержит «,» или другой стандартный разделитель.
symlink_block_empty
Используется в том случае, если необходимо вывести на страницу сообщение о том, что значение поля типа «Выпадающий список с множественным выбором» пустое.
tags_block
Требует присутствия блоков tags_item и tags_empty.
- %items%
-
Выводит список значений, используя блок tags_item .
tags_empty
Используется в том случае, если необходимо вывести на страницу сообщение о том, что значение поля типа «Тег» пустое.
optioned_block
Выводит содержимое для опционного поля, которое содержит список выбранных элементов справочника.
- %field_id%
-
Выводит id поля.
- %field_name%
-
Выводит имя поля.
- %name%
-
Выводит имя поля.
- %title%
-
Выводит название поля.
- %items%
-
Выводит отдельное значение для поля.
optioned_block_empty
Используется в том случае, если необходимо вывести на страницу сообщение о том, что значение поля типа «Опционное» пустое.
- %field_id%
-
Выводит id поля.
- %field_name%
-
Выводит имя поля.
- %name%
-
Выводит имя поля.
- %title%
-
Выводит название поля.
- %items%
-
Выводит отдельное значение для поля.
optioned_item
Выводит отдельное значение поля типа optioned.
- %int%
-
Выводит числовое значение поля.
- %float%
-
Выводит значение поля типа "число с точкой".
- %text%
-
Выводит текстовое значение поля.
Значения int, float, text могут быть пустыми.
- %varchar%
-
Выводит строковое значение поля.
- %field_name%
-
Выводит имя поля, к которому относится значение.
Значения, которые появляются, если поле справочник не пустое:
- %object-id%
-
Выводит id объекта для значения справочника.
- %object-name%
-
Выводит имя объекта для значения справочника.
Если имеется ссылка на дерево, то появляются также значения:
- %element-id%
-
Выводит id дерева, на которое ссылается поле.
- %element-name%
-
Выводит имя дерева, на которое ссылается поле.
- %element-link%
-
Выводит ссылку на дерево.
Примеры использования
Откройте для редактирования любую страницу контента, либо любой шаблон дизайна.
В поле HTML-редактор, либо в шаблон дизайна вставьте макрос: %data getPropertyOfObject(%current_user_id%, 'login', 'sample')%.
В папке /tpls/data создайте файл sample.tpl, который содержит следующий пример:
<?php
$FORMS = Array();
$FORMS['string'] = <<<END
Значение поля <b>%title%</b> равно <span style='color: red;'>"%value%"</span>
END;
?>
Зайдите на страницу, которую вы редактировали, либо на страницу, которая использует отредактированный шаблон дизайна. Вы увидите приблизительно следующую надпись: «Значение поля Логин равно 'somelogin'».
Название
%data getPropertyOfObject()% — Выводит свойство объекта по определенному шаблону
Параметры: data getPropertyOfObject(object_id, prop_name [, template = 'default', is_random = '0'])
- object_id
-
id объекта (например, пользователя или значения справочника), свойство которого необходимо вывести.
- prop_name
-
Название свойства, которое необходимо вывести. В модуле «Шаблоны данных» это поле называется «Идентификатор».
- template
-
Имя шаблона, по которому следует вывести свойство.
- is_random
-
Этот параметр используется только при выводе значения полей типа «Ссылка на дерево», либо «Выпадающий список с несколькими значениями». Если параметр is_random равен «1», то из списка значений будет случайным образом выбрана только 1 страница, либо объект. Для всех остальных типов полей этот параметр макроса игнорируется.