Описание функции wp_count_terms()
Функция wp_count_terms() используется для подсчета количества терминов в указанной таксономии. Она позволяет быстро получить количество терминов, что полезно для отображения информации о таксономиях в темах и плагинах.
Функция возвращает целое число, представляющее количество терминов в заданной таксономии или false в случае ошибки.
Параметры
$taxonomy
Тип: string
Обязательный: Да
Описание: Имя таксономии, для которой необходимо подсчитать термины
Возможные значения:
0: category
1: post_tag
2: custom_taxonomy
$args
Тип: array
Обязательный: Нет
По умолчанию: array()
Описание: Дополнительные аргументы для фильтрации терминов
Возможные значения:
hide_empty: 1,
parent: ID родительского термина
Возвращаемое значение
Тип: int|false
Описание: Количество терминов в заданной таксономии или false в случае ошибки
Возможные значения:
• Целое число, если термины найдены
• false, если произошла ошибка или таксономия не найдена
Примеры использования
Базовый пример подсчета всех терминов в таксономии категорий
$count = wp_count_terms('category');
// Вывод количества категорий
echo 'Количество категорий: ' . $count;
Количество категорий: 5
Подсчет непустых терминов в таксономии категорий
$count = wp_count_terms('category', array('hide_empty' => true));
// Вывод количества непустых категорий
echo 'Количество непустых категорий: ' . $count;
Количество непустых категорий: 3
Обработка случая, когда таксономия не найдена
$count = wp_count_terms('invalid_taxonomy');
if ($count === false) {
echo 'Таксономия не найдена';
} else {
echo 'Количество терминов: ' . $count;
}
Таксономия не найдена
Безопасность
Валидация входных данных: Параметр taxonomy проверяется на наличие в зарегистрированных таксономиях
Санитизация: Аргументы очищаются WordPress
Рекомендации: Используйте wp_unslash() для строковых параметров перед вызовом функции
— Связанные функции
Получает массив терминов по заданным параметрам
Получает термины для конкретной записи
— Хуки
Фильтрует аргументы перед подсчетом терминов
— Примечания
– Ограничения
Возвращает только публичные термины по умолчанию
– Частые проблемы
- false, если передана несуществующая таксономия
- Неправильное значение hide_empty может привести к неверным подсчетам
