Логотип

Документация по макросам и шаблонам UMI.CMS

content pagesByDomainTags()

Название

%content pagesByDomainTags()% — Выводит элементы иерархии (страницы сайта), которым назначен один из указанных тегов, на основании анализа страниц текущего домена.

Параметры: content pagesByDomainTags([s_tags = ', s_template = 'tags', s_base_types = ', i_per_page = '10', b_ignore_paging = '0'])

s_tags

Список интересующих тегов.

s_template

Шаблон отображения результатов.В XSLT-шаблонизаторе игнорируется.

s_base_types

Список интересующих базовых типов.

i_per_page

Количество элементов, которые будут выведены на странице. По умолчанию 10.

b_ignore_paging

Игнорировать или не игнорировать разбиение по страницам. Если будет выбрано "игнорировать", то будут показаны только первые i_per_page элементов.

Описание

Выводит элементы иерархии (страницы сайта), которым назначен один из указанных тегов, на основании анализа страниц текущего домена. Макрос можно вызвать непосредственно из адресной строки следующим образом:/content/pagesByDomainTags/s_tags/s_template/s_base_types.

Теги можно задать в редактировании любой страницы сайта в соответствующем поле.

Пример вызова

udata://content/pagesByDomainTags/(ледяной дворец)

XML-ответ UData

<udata module="content" method="pagesByDomainTags" generation-time="0.012022">
  <items>
    <item id="87" link="/gt/post_pervogo_bloga/" publish_time="1258115400">пост первого блога</item>
    <item id="35" link="/butterfly/ptica/">Птица</item>
    <item id="36" link="/butterfly/derevo/">Дерево</item>
    <item id="37" link="/butterfly/pustynya/">Пустыня</item>
    <item id="38" link="/butterfly/vodopad/">Водопад</item>
    <item id="64" link="/ewe_blog1/">Еще блог</item>
  </items>
  <tags>ледяной дворец</tags>
  <total>6</total>
  <per_page>10</per_page>
</udata>

Элементы и атрибуты

<items>

Ветвь, содержащая элементы item — страницы с указанными в параметре s_tags тегами.

<item>

Элемент описывающий страницу с указанными тегами.

@id

Идентификатор страницы.

@link

Путь до страницы. В случае страницы другого домена, будет указан полный путь вида http://домен/ссылка_на_страницу/

@publish_time

Время публикации в UNIX TIMESTAMP. Выводится для тех страниц, у которых есть это поле.

<tags>

Список тегов через запятую.

<total>

Общее количество страниц, с запрошенными тегами.

<per_page>

Количество элементов, отображаемое на странице.

Вывод списка страниц осуществляется по шаблону, указанному в параметре $s_template. Вы можете не указывать этот параметр, в этом случае для будет использован шаблон по умолчанию — tags.tpl.

Используемые шаблоны

Макрос оперирует шаблонами, находящимися в каталоге /tpls/content/.

Используемые блоки шаблона

pages

Выводит оформляющий блок для списка страниц.

%items%

Выводит список страниц, сформированный при помощи блока page .

%tags%

Выводит параметр s_tags без изменений.

pages_empty

Выводится в качестве результата работы макроса, если список страниц пуст (не найдено ни одной страницы, удовлетворяющей параметрам макроса).

page

Задает формат вывода каждой страницы в списке.

%id%

id страницы, можно использовать в других макросах.

%name%

Название страницы.

%link%

url страницы.

%publish_time%

Дата публикации страницы. Имеет смысл только для новостей и сообщений блогов (поскольку только для них определено и автоматически заполняется поле дата публикации).

Примеры использования

<?php

$FORMS = array();

$FORMS['pages'] = "Эти страницы используют теги %tags%:<ul>%items%</ul><p>%system numpages(%total%, %per_page%)%</p>";
$FORMS['pages_empty'] = "";
$FORMS['page'] = "<li><a href=\"%link%\">%name%</a></li>";

?>