wp_count_terms()
Вважає скільки в таксономії елементів (термінів), із записами чи без записів.
Працює на основі:
get_terms()
get_terms()
1 раз – 0.000664 сек
(повільно) | 50000 разів – 26 сек
(повільно)
(повільно) | 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. |