Логотип

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

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

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

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

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

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

cloud_tags

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

%items%

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

%context%

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

cloud_tags_empty

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

cloud_tag

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

%tag%

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

%tag_urlencoded%

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

%font%

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

%weight%

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

%context%

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

cloud_tagseparator

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

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

В шаблоны дизайна вставьте макрос: %content tagsAccountEfficiencyCloud('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'] = ", ";

?>

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

Название

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

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

s_template

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

Описание

Данный макрос выводит облако тегов всех страниц в структуре сайта, подобно макросу tagsAccountUsageCloud, но назначает им «веса» в зависимости от эффективности. Под эффективностью в данном случае понимается некоторый условный показатель, рассчитываемый по простому алгоритму как отношение относительной популярности тега (см. %content tagsDomainCloud()%) к его относительному коэффициенту использования (см. %content tagsDomainUsageCloud()%). То есть, чем меньше страниц отмечены каким-то тегом и чем больше посетителей открыло такие страницы, тем выше «эффективность» тега.

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

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