Логотип

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

content tagsAccountCloud()

Название

%content tagsAccountCloud()% — Выводит облако тегов аккаунта (всех сайтов системы).

Параметры: content tagsAccountCloud([s_template = 'tags'])

s_template

Имя шаблона для отображения результатов.

Описание

Облако тегов, которые собрали пользователи на сайте. Это список тегов тех страниц сайта, которые открывали посетители. Чем больше посещений было сделано на страницы с определенным тегом, тем больше его «вес» в облаке, что можно отразить визуально при помощи шаблона вывода.

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

Макрос формирует вывод исходя из данных статистики. Если вы хотите ограничить выборку из статистики каким-то календарным периодом, передайте в http-запросе к странице, содержащей данный макрос, параметры fd — день начала периода (1..31), fm — месяц начала периода (Jan, Feb, ...) fy — год начала периода (2005, 2006, ...), td — день окончания периода (1..31), tm — месяц окончания периода (Jan, Feb, ...) ty — год окончания периода (2005, 2006, ...).

Не используется.

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

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

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

cloud_tags

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

%items%

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

%context%

Значение для данного макроса равно строке «account». Так как макрос tagsAccountCloud имеет парный, тоже отображающий облако тегов, но для текущего сайта (tagsDomainCloud), то для возможности использования одного и того же шаблона введен внутренний макрос context. См., например, применение данного макроса в примере к текущей статье.

cloud_tags_empty

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

cloud_tag

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

%tag%

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

%tag_urlencoded%

Выводит название тега в закодированном виде, предназначенном для передаче в качестве параметра http-запроса.

%font%

Целое число от 10 до 32, которое можно использовать с качестве размера шрифта для визуализации «веса»" тега в облаке. Это число коррелирует со следующим макросом — «весом» тега.

%weight%

«Вес» тега в облаке в процентах. Дробное число от 0 до 100, округленное до одного знака после запятой (например, 0.1, 22, 14.4).

%context%

Значение для данного макроса равно строке «account». Так как макрос tagsAccountCloud имеет парный, тоже отображающий облако тегов, но для текущего сайта (tagsDomainCloud), то для возможности использования одного и того же шаблона введен внутренний макрос context. См., например, применение данного макроса в примере к текущей статье.

cloud_tagseparator

Содержит разделитель, который выводится между тегами.

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

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

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


<?php

$FORMS = array();

$FORMS['cloud_tags'] = "%items%";
$FORMS['cloud_tags_empty'] = "";

$FORMS['cloud_tag'] = "<a href=\"/content/pagesBy%context%Tags/%tag_urlencoded%\" style=\"font-size:%font%pt;\">%tag%</a>";

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

?>

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