Создание облака тегов Wordpress - wp_tag_cloud

2010-02-26 16:09:24

Wordpress info / Разработка под Wordpress / Создание облака тегов Wordpress - wp_tag_cloud

Облако тегов — это форма представления данных, представляющая собой совокупность ключевых слов.
Ключевое слово — это слово в тексте или статье, которое в совокупности с другими ключевыми словами способно представлять текст. Набор ключевых слов по смыслу соответствует аннотации, плану. Таким образом, облако тегов — это как бы аннотация к вашему сайту или блогу. Ну, а технически, облако тегов - это всего лишь ссылки с ключевыми словами

В Wordpress же (начиная с версии 2.3), для создания облака тегов доступна функция <?php wp_tag_cloud(''); ?>
Параметры, которые может принимать функция:

• smallest (целочисленный) - размер текста с минимальным значением счётчика
• largsest (целочисленный) - размер текста с максимальным значением счётчика
• unit (строка) - единица измерения
• number (целочисленный) - количество тегов, одновременно отображаемых в облаке (для вывода всех тегов без ограничений используйте 0)
• format (строка) - формат вывода облака тегов на экран. Может принимать следующие значения: flat, list, array
• orderby (строка) - упорядочивание тегов по name (имени), count (количеству - значению счётчика)
• sort (строка) - сортировка тегов по: ASC (возрастанию), DESC (убыванию), RAND (в случайном порядке)
• exclude (строка) - список невключаемых тегов (term_id)
• include (строка) - список включаемых тегов

Напомню, что параметры в функцию передаются следующим образом:

wp_tag_cloud('param1=value&param2=value2');
//например:wp_tag_cloud('format=list&orderby=count&sort=RAND');

Теперь более подробно о параметрах.
Параметры smalllest и largest задают минимальный и максимальный размер шрифта, используемого в ссылке, в зависимости от количества упоминаний данного тега
Unit - это единица измерения (пункты (pt, по умолчанию), пиксели, и т.п.) размера шрифта. Т.е., Вы указываете smallest=10&unit=pt и это означает, что минимальный размер шрифта равняется десяти пунктам.
С помощью параметра number можно указать максимальное количество тегов в облаке. Если ограничивать количество не нужно - можно указать ноль.
Интересный параметр format - с его помощью можно настроить формат вывода тегов. Параметр принимает значения: flat (по умолчанию) - теги в облаке выводятся строкой, list - теги выводятся списком и array - теги никак не выводятся, функция просто возвращает массив тегов.
Параметры orderby и sort предназначены для сортировки тегов. orderby=name отсортирует теги по алфавиту, orderby=count - по значению. sort для порядка сортировки: sort=asc отсортирует по возрастанию, sort=desc - по убыванию, ну а sort=rand перемешает теги и выведет в случайном порядке.

Использовать же функцию в Вашем шаблоне (например, в sidebar.php) можно так:

<?php if ( function_exists('wp_tag_cloud') ) : ?>
<li><h2> Теги (метки) </h2>
  <ul>
    <?php wp_tag_cloud('format=list&orderby=count&sort=desc'); ?>
 </ul>
</li>
<?php endif; ?>

Экспериментируйте!