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	Змінена функція signature so that the `$args` array може бути здійснений as first parameter.

wp count terms ^{WP 6.0.2}

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);
}

wp_count_terms() │ WP 2.3.0

Повертає

Використання

WP 5.6

WP 5.5 і менше

Приклади

#1 Порахуємо елементи таксономії ‘taxa’

#2 Порахуємо елементи таксономії ‘taxa’

список змін

wp count terms WP 6.0.2

Зв’язані функції

count (підрахунок кількості)

Будь-які таксономії

Залишити відповідь Скасувати коментар

wp count terms ^{WP 6.0.2}