Вывод списка тегов всех постов блогов

Актуально для версии 2.9

Задача:

Вывести по шаблону список тегов всех постов блогов.

Решение:

Для решения данной задачи воспользуемся протоколом выборки данных - "Selector". Напишем макрос, который с помощью Selector'a будет формировать список тегов и выводить их по шаблону:

Листинг 1. Код макроса

/*
  @param String 
    $template - шаблон вывода для TPL
  @param Integer
    $limit - количество выводимых тегов
 */
public function tagList($template = 'default', $limit = false) {
  $posts = new selector('pages');
  $posts->types('hierarchy-type')->name('blogs20', 'post');
    
  $tags = array();
  foreach($posts as $post)
    $tags = array_merge($tags, $post->tags);
    
  $tags = array_values(array_unique($tags));
    
  if(!$template)
    $template = 'default';

  list($tags_block, $tags_block_tag, $tags_block_empty) = 
    def_module::loadTemplates('blogs20/tags/'.$template, 'tags_block', 'tags_block_tag', 'tags_block_empty');

  $total = count($tags);
  if($total > 0) {
    if($limit)
      $total = (($limit < $total) ? $limit : $total);
    
    $lines = array();
    for($i = 0; $i < $total; $i++) {
      $line_arr = array();
      $line_arr['tag'] = $tags[$i];
    
      $lines[] = def_module::parseTemplate($tags_block_tag, $line_arr, $tags);
    }
    
    $block_arr = array();
    $block_arr['void:lines'] = $lines;
 
    return def_module::parseTemplate($tags_block, $block_arr);
  } else {
    return $tags_block_empty;
  }
}

Код макроса поместим в файл "/classes/modules/blogs20/__custom.php" после строки "//TODO: Write here your own macroses". Теперь нам нужно добавить разрешения для макроса. Для этого создадим в той же директории файл "permissions.custom.php" со следующим содержанием:

Листинг 2. Добавление разрешений

<?php
$permissions = Array(
  'common' => array('tagList')
);
?>

Если Вы используете TPL шаблонизатор, также необходимо сделать шаблон, по которому будет организован вывод тегов. В папке "/tpls/blogs20/" создаём папку "tags", а в ней создаём файл "default.tpl" и размещаем в нём текст:

Листинг 3. Шаблон вывода тегов для TPL

<?php
$FORMS = Array();

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

<div>%lines%</div>

END;

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

<span> - <b>%tag%</b> - </span>

END;

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

<b>Пусто!</b>

END;

?>

Блок "tags_block" - контейнер списка тегов, внутри блока используется макрос %lines%, на его место подставляется код, указанный в блоке "tags_block_tag". Блок "tags_block_tag" предназначен для отдельно взятого тега, текст тега доступен через макрос %tag%. Блок "tags_block_empty" подставляется в том случае, если список тегов пуст.

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

Листинг 4. Пример использования макроса в TPL

%blogs20 tagList(20)%

Листинг 5. Пример использования макроса в XSLT

<xsl:value-of select="document('udata://blogs20/tagList/20/')/lines/tag/." disable-output-escaping="yes" />