Функции шаблона/wp tag cloud

Оригинал этой страницы на английском здесь. Этот перевод мой. Ссылки отображённые красным текстом, неактивны

Описание

Начиная с версии WordPress 2.3, фукция шаблона wp_tag_cloud отображает список меток при помощи так называемого 'облака меток', размер метки определяется количеством записей, для которой она назначена.

Применение 

<?php wp_tag_cloud(''); ?>

Примеры 

Применение по умочанию

$defaults = array('smallest' => 8, 'largest' => 22, 'unit' => 'pt', 'number' => 45, 'format' => 'flat', 'orderby' => 'name', 'order' => 'ASC','exclude' => , 'include' => );

По умолчанию отображается:

• smallest - метка содержащаяся в самом меньшем количестве записей будет отображаться размером 8
• largest - метка содержащаяся в самом большрм количестве записей будет отображаться размером 22
• unit - Описывает 'pt' (точки) как размер шрифта для наибольшего и наименьшего значения
• number - Отображает 45 меток с наибольшим количеством записей
• format - Отображает метки в стиле разделённые интервалом
• orderby - Упорядочить метки по имени
• order - Сортировать метки по возрастанию
• exclude - Неисключать метки
• include - Включать все метки

В облаке отображаются популярные метки

<?php if ( function_exists('wp_tag_cloud') ) : ?> <li> <h2>Популярные метки</h2> <ul> <?php wp_tag_cloud('smallest=8&largest=22'); ?> </ul> </li> <?php endif; ?>

Облако ограничено по размеру и упорядочено по количеству записей, а не по имени

<?php wp_tag_cloud('smallest=8&largest=22&number=30&orderby=count'); ?>

облако возвращается в виде массива, но не отображается

Переменная $tag будет содержать метку для применения в другом PHP коде

<?php $tag = wp_tag_cloud('format=array' );?>

Параметры

smallest 

(целое число) Размер текста метки с минимально возможной величиной (units given by unit параметре).

largest 

(целое число) Размер текста метки с максимально возможной величиной (данные устанавливаются в unit параметре).

unit 

(строка) Единица измерения соответствует минимальному (smallest) и максимальному значению. Может быть любым CSS длины значением, e.g. pt, px, em, %; по умолчанию pt (точки).

number 

(целое число) Количество меток для отображения в облаке. (Если '0' отобразятся все метки.)

format 

(строка) Формат отображения облака.

• 'flat' (По умолчанию) метки разделены пробелом
• 'list' метки в UL с class='wp-tag-cloud'
• 'array' метки возвращаются в массив и функцию для использования массива облака меток в PHP Примечание: массив возвращается, но не отображается, был введён вVersion 2.5.

orderby 

(строка) Упорядочивание меток. Правильные значения:

• 'name' (По умолчанию)
• 'count'

порядок 

(строка) Порядок сортировки. Правильные значения - Должно быть в верхнем регистре:

• 'ASC' (По умолчанию)
• 'DESC'
• 'RAND' метки отображаются в произвольном порядкею Этот параметр был введён в версии 2.5

exclude 

(строка) Запятая разделяет записи в метках (term_id) для исключения. Для примера, 'exclude=5,27' метки имеющие term_id 5 или 27 не будут отображены. По умолчанию ничего не исключать.

include 

(строка) Запятая разделяет список меток (term_id) для включения. Для примера, 'include=5,27' будут отбражаться только метки у которых есть term_id 5 или 27. По умолчанию включать всё.

Создание архива меток

Новая характеристика меток в 2.3 как дополнение, wp_tag_cloud метка используется для отображения Архива Меток. Когда посетитель щелкает на любую конкретную метку, отображенную в облаке меток, то все записи с этой метки будут отображены. Согласно Иерархии Шаблонов если файл tag.php шаблона не существует, будет использоваться файл archives.php шаблона. Сделав файл tag.php шаблоном, вы можете модифицировать по заказу пользователя путь, к вашему Архиву Меток, этот шаблон включает Облако Меток вверху, для быстрой навигации.

Чтобы сделать это новым шаблоном нужно добавить к вашим файлам темы. Ресурсы, которыйе относятся к вопросам шаблоны, Иерархия Шаблонов. Основные шаги:

• 1. Создать файл с кодом который будет показан ниже и назвать его tag.php.
• 2. Загрузите файл в вашу директорию с темами.
• 3. Это не является обязательным только в том случае, если вы хотите иметь ссылку на вашу страницу навигации для архив меток, в противном случае при нажатии на метку будет использоваться этот шаблон.
  • Создать новую пустую страницу, используя этот шаблон, дать этой странице заголовок Архив Создать новую пустую страницу, используя этот шаблон, придать этой странице заголовок тегов Архив Меток.

To elobarate более трёх шагов.

WordPress можно сконфигурировать для использования Шаблона Страницы для разных страниц. Выбрать закладки Написать -> Написать страницу в админ панели (или в sidebar, в зависимости от используемой версии WordPress) и в раскрывающемся списке"Шаблон страницы", вы можете выбрать какой шаблон будет использоваться при отображении конкретной страницы.

<?php /* Название шаблона: Архив меток */ ?> <div> <?php get_header(); ?> <h2>Tag Archive</h2> <?php wp_tag_cloud(''); ?> <div class="navigation"> <div class="alignleft"><?php next_posts_link('« Older Entries') ?></div> <div class="alignright"><?php previous_posts_link('Newer Entries »') ?></div> </div> <?php if (have_posts()) : ?> <?php while (have_posts()) : the_post(); ?> <h2><a href="<?php the_permalink() ?>" rel="bookmark" title="Permanent Link to <?php the_title(); ?>"><?php the_title(); ?></a></h2> <div class="entry"> <?php the_content('Read the rest of this entry »'); ?> </div> <?php endwhile; ?> <?php endif; ?> </div> <?php get_footer(); ?>

Примечание, стили не добавлены в этот шаблон. Способ определить структуру, которую использует ваша тема, это посмотреть файл single.php темы.