Функция wp_count_terms() в WordPress позволяет подсчитывать количество терминов, содержащихся в указанной таксономии. Это полезно для получения информации о структуре ваших таксономий и управления ими.
wp_count_terms( array|string $args = array(), array|string $deprecated = ” ): string|WP_ErrorФункция возвращает количество терминов в заданной таксономии. По умолчанию функция подсчитывает только непустые термины (термины, связанные с записями), но вы можете настроить это поведение с помощью параметров.
Параметры
- $args (array|string) — Массив или строка с параметрами, принимаемыми функцией
get_terms(). Наиболее часто используемые параметры:- taxonomy (string) — Название таксономии.
- hide_empty (bool) — Определяет, учитывать ли термины без записей:
true(1) — Подсчет только терминов с записями.false(0) — Подсчет всех терминов, включая пустые.
- $deprecated (array|string) — Устаревший параметр, используемый в предыдущих версиях WordPress. Если указан, будет интерпретироваться как
$args.
Возвращаемое значение
- string — Числовая строка, содержащая количество терминов в таксономии.
- WP_Error — Если указанная таксономия не существует.
Пример 1: Подсчет терминов в таксономии
Для версии WP 5.6 и выше можно использовать следующий код для подсчета терминов в таксономии «year»:
// Подсчет всех терминов в таксономии 'taxa'
echo wp_count_terms(['taxonomy' => 'year', 'hide_empty' => false]); // Например, вывод: > 76
Пример 2: Разные варианты подсчета терминов
Предположим, в таксономии «my_custom_taxonomy» имеется 50 терминов, ассоциированных с записями, и 50 пустых терминов. Мы можем узнать общее количество терминов следующим образом:
// Подсчет всех терминов, включая пустые
echo wp_count_terms('my_custom_taxonomy', 'hide_empty=0'); // Вывод: 100
// Подсчет только тех терминов, которые содержат записи
echo wp_count_terms('my_custom_taxonomy', 'hide_empty=1'); // Вывод: 50
// Применение массива для задания параметров
echo wp_count_terms('my_custom_taxonomy', ['hide_empty' => 1]); // Вывод: 50
// Проверка наличия таксономии и вывод количества
$count = wp_count_terms('my_custom_taxonomy', ['hide_empty' => 1]);
if (!is_wp_error($count)) {
echo $count; // Вывод: 50
}
Заключение
Функция wp_count_terms() является мощным инструментом для работы с таксономиями в WordPress. Она позволяет легко получать информацию о количестве терминов, что может быть полезно при создании отчетов или статистики по контенту вашего сайта. Убедитесь, что вы правильно используете параметры функции для получения нужных результатов.
