wp_count_terms() │ WP 2.3.0

Считает сколько в таксономии элементов (терминов), с записями или без записей.

Работает на основе: get_terms()

1 раз — 0.000664 сек (медленно) | 50000 раз — 26 сек (медленно)

Хуков нет.

Возвращает

Строку|WP_Error. Сколько терминов в таксономии. WP_Error, если таксономии не существует.

Использование

WP 5.6

wp_count_terms( $args );

$args(массив/строка)

Может принимать все те же параметры что и get_terms().

Однако, как правило, смысл имеет указывать лишь:

taxonomy(строка)
Название таксономии.
hide_empty(true/false)
true/1 - будут подсчитаны элементы с записями.
false/0 - будут подсчитаны все элементы.

По умолчанию: array()

WP 5.5 и меньше

wp_count_terms( $taxonomy, $args );

$taxonomy(строка) (обязательный)

Название таксономии.

$args(массив/строка)

Может принимать все те же параметры что и get_terms(). Однако, как правило, смысл имеет указывать лишь один аргумент: hide_empty. Передавать остальные параметры обычно смысла нет. Этот параметр определяет считать ли пустые элементы таксономии:

hide_empty=1 - спрятать пустые элементы, значит будут подсчитаны элементы с записями.
hide_empty=0 - не прятать элементы, значит будут подсчитаны все элементы.

По умолчанию: array()

Примеры

#1 Посчитаем элементы таксономии 'taxa'

Для версии WP 5.6+:

echo wp_count_terms( [ 'taxonomy'=>'taxa', 'hide_empty'=>false ] ); // > 100

#2 Посчитаем элементы таксономии 'taxa'

Демонстрация работы функции. Допустим у нас есть таксономия taxa и в ней 50 элементов с записями и 50 пустых.

// все элементы с пустыми
echo wp_count_terms( 'taxa', 'hide_empty=0' ); // > 100

// только элементы с записями
echo wp_count_terms( 'taxa', 'hide_empty=1' ); // > 50

// можно записывать в виде массива
echo wp_count_terms( 'taxa', array('hide_empty'=>1) ); // > 50

// Убедимся что такса есть
$count = wp_count_terms( 'taxa', array('hide_empty'=>1) );
if( ! is_wp_error($count) )
	echo $count; // > 50

Список изменений

С версии 2.3.0	Введена.
С версии 5.6.0	Changed the function signature so that the `$args` array can be provided as the first parameter.

Код `wp_count_terms() wp count terms` ^{WP 6.7.1}

wp-includes/taxonomy.php

function wp_count_terms( $args = array(), $deprecated = '' ) {
	$use_legacy_args = false;

	// Check whether function is used with legacy signature: `$taxonomy` and `$args`.
	if ( $args
		&& ( is_string( $args ) && taxonomy_exists( $args )
			|| is_array( $args ) && wp_is_numeric_array( $args ) )
	) {
		$use_legacy_args = true;
	}

	$defaults = array( 'hide_empty' => false );

	if ( $use_legacy_args ) {
		$defaults['taxonomy'] = $args;
		$args                 = $deprecated;
	}

	$args = wp_parse_args( $args, $defaults );

	// Backward compatibility.
	if ( isset( $args['ignore_empty'] ) ) {
		$args['hide_empty'] = $args['ignore_empty'];
		unset( $args['ignore_empty'] );
	}

	$args['fields'] = 'count';

	return get_terms( $args );
}