Логотип

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

content tagsAccountUsageCloud()

Название

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

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

s_template

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

Описание

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

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

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

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

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

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

cloud_tags

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

%items%

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

%context%

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

cloud_tags_empty

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

cloud_tag

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

%tag%

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

%tag_urlencoded%

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

%font%

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

%weight%

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

%context%

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

cloud_tagseparator

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

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

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

?>

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