Документация WordPress

wp_tag_cloud

Функция wp_tag_cloud() в WordPress используется для отображения «облака тегов» (списка тегов с визуальным выделением, обычно основанным на их частоте использования). Функция выводит HTML-код, который представляет облако тегов, где каждый тег имеет разный размер шрифта в зависимости от его популярности.

Синтаксис

wp_tag_cloud( $args = '' );

$args (массив или строка, необязательный): Массив параметров для настройки вывода облака тегов. По умолчанию использует значения по умолчанию. Может быть передан в виде строки в формате запроса (например, 'smallest=8&largest=22') или в виде ассоциативного массива.

Основные параметры

smallest (число, необязательный): Размер шрифта для самого маленького тега. По умолчанию: 8.
largest (число, необязательный): Размер шрифта для самого большого тега. По умолчанию: 22.
unit (строка, необязательный): Единица измерения размера шрифта. Например: 'pt', 'px', 'em'. По умолчанию: 'pt'.
number (число, необязательный): Количество отображаемых тегов. По умолчанию: 45.
format (строка, необязательный): Формат отображения облака тегов. Возможные значения:
- 'flat' — обычный список тегов (по умолчанию),
- 'list' — теги отображаются в виде <ul><li></li></ul>.
separator (строка, необязательный): Разделитель между тегами при использовании формата 'flat'. По умолчанию — пробел.
orderby (строка, необязательный): Критерий сортировки тегов. Возможные значения:
- 'name' — по имени,
- 'count' — по количеству использования.
order (строка, необязательный): Порядок сортировки тегов: 'ASC' (по возрастанию) или 'DESC' (по убыванию).
taxonomy (строка или массив, необязательный): Таксономия для вывода тегов. По умолчанию: 'post_tag'.
echo (логический, необязательный): Выводить облако тегов или просто вернуть HTML-код. По умолчанию: true (выводить).

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

В этом примере мы выводим 20 самых популярных тегов в виде списка <ul><li></li></ul>, с размерами шрифта от 10 до 30 пикселей.

Получение облака тегов без вывода:

Этот код возвращает HTML-код облака тегов, который затем можно поместить в кастомный контейнер и вывести в нужном месте.

Применение в WordPress

Функция wp_tag_cloud обычно используется в виджетах боковой панели для отображения облака тегов, но также может применяться в шаблонах тем, на страницах архивов или других частях сайта. Она полезна для отображения наиболее популярных тегов или категорий, что помогает пользователям легко находить контент по темам.

theme