Описание функции wp_generate_tag_cloud()
Функция wp_generate_tag_cloud() создает HTML-код для облака тегов, позволяя пользователям просматривать и взаимодействовать с тегами в WordPress. Функция поддерживает различные параметры для настройки отображения тегов, таких как количество тегов, порядок и вес тегов.
Облако тегов помогает улучшить навигацию по сайту и SEO, предоставляя пользователям доступ к популярным темам
Параметры
$args
Тип: array
Обязательный: Нет
По умолчанию: array()
Описание: Массив аргументов для настройки облака тегов
Возможные значения:
smallest: Минимальный размер шрифта для тегов
largest: Максимальный размер шрифта для тегов
unit: Единица измерения (например, ‘pt’, ‘px’)
number: Количество тегов для отображения
orderby: name, count
order: ASC, DESC
include: Массив ID тегов для включения
exclude: Массив ID тегов для исключения
taxonomy: Таксономия для тегов (по умолчанию ‘post_tag’)
Возвращаемое значение
Тип: string
Описание: HTML-код облака тегов
Возможные значения:
• HTML-код для отображения облака тегов
• Пустая строка, если теги не найдены
Примеры использования
Создает и отображает облако тегов с настройками по умолчанию
$tag_cloud = wp_generate_tag_cloud();
echo $tag_cloud;
// Выводит облако тегов
Облако тегов будет создано на основе всех доступных тегов
Создает облако тегов, ограниченное 20 наиболее популярными тегами
$args = array(
'smallest' => 10,
'largest' => 22,
'number' => 20,
'orderby' => 'count',
'order' => 'DESC'
);
$tag_cloud = wp_generate_tag_cloud($args);
// Вывод облака тегов с заданными параметрами
Теги отсортированы по количеству записей
Безопасность
Валидация входных данных: Все параметры проходят валидацию внутри функции
Санитизация: Параметры автоматически очищаются WordPress
Рекомендации: При выводе данных используйте esc_html() для защиты от XSS
— Связанные функции
Получает список тегов с возможностью фильтрации
Старый аналог для генерации облака тегов
— Хуки
Фильтрует облако тегов перед его выводом
— Примечания
– Ограничения
Возвращает только публичные теги по умолчанию
– Частые проблемы
- Пустой результат при отсутствии тегов
- Некорректное отображение при неверных параметрах
