Логотип

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

stat tagsCloud()

Название

%stat tagsCloud()% — Выводит облако собранных тегов сайта.

Параметры: stat tagsCloud([template = 'default', limit = '50', maxFontSize = '16'])

template

Имя шаблона, по которому следует вывести облако тегов.В XSLT-шаблонизаторе игнорируется, можно указать любое значение.

limit

Максимальное количество выводимых тегов.

maxFontSize

Максимальный размер шрифта для вывода тегов.

Описание

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

Выводится список тегов со статистикой и рекомендуемым размером шрифта. Код облака тегов необходимо самостоятельно определить в шаблоне.

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

udata://stat/tagsCloud/notemplate/20/20

XML-ответ UData

<udata module="stat" method="tagsCloud" generation-time="0.117258">
  <lines>
    <item cnt="6" font-size="20">фото</item>
    <item cnt="2" font-size="7">кино</item>
    <item cnt="2" font-size="7">невский</item>
    <item cnt="5" font-size="17">PHP manual</item>
    <item cnt="4" font-size="14">питер</item>
    <item cnt="5" font-size="17">ледяной дворец</item>
    <item cnt="3" font-size="10">дерево</item>
  </lines>
  <total>7</total>
  <per_page>20</per_page>
</udata>

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

<lines>

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

<item>

Элемент, описывающий отдельный тег.

@cnt

Число, показывающее сколько раз этот тег был собран посетителями.

@font-size

Рекомендуемый размер шрифта для создания облака.

<total>

Общее количество собранных тегов.

<per_page>

Количество тегов выводимое на странице.

Вывод облака тегов осуществляется по шаблону, указанному в параметре template. Вы можете не указывать этот параметр, в этом случае для вывода свойства будет использован шаблон по умолчанию — default.tpl.

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

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

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

tags_block

Выводит оформляющий блок для облака тегов.

%lines%

Выводит список тегов, сформированный из блока tags_block_line .

tags_block_line

Выводит отдельный тег в облаке тегов.

%font_size%

Выводит размер шрифта для тега.

%tag%

Выводит название тега.

%separator%

Выводит разделитель используя блок tags_separator .

%list-class-first%

в случае, если элемент первый, выводит "first"

%list-class-last%

в случае, если элемент последний, выводит "last"

%list-class-odd%

в случае, если элемент четный, выводит "odd"

%list-class-even%

в случае, если элемент нечетный, выводит "even"

%list-position%

вставляет порядковый номер в списке

tags_separator

Содержит разделитель, можно выводить между между тегами.

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

В шаблоны дизайна вставьте макрос: %stat tagsCloud('sample', 10)%.

В папке /tpls/stat создайте файл sample.tpl, который содержит следующий пример:

<?php

$FORMS = Array();

$FORMS['tags_block'] = <<<END

 <div style="border: #000 1px solid;">
  %lines%
 </div>

END;

$FORMS['tags_block_line'] = <<<END

 <font style="font-size: +%font_size%pt;>%tag%</font>
 %separator%

END;

$FORMS['tags_separator'] = ", ";

?>

Зайдите на страницу сайта. Если при создании страниц вы указывали им теги, то вы увидите облако тегов.