Question

wp_count_terms( string $taxonomy,  array|string $args = array() )

Count how many terms are in Taxonomy.

---

description

Default $args is ‘hide_empty’ which can be ‘hide_empty=true’ or array(‘hide_empty’ => true).

---

参数

$taxonomy

(string) (Required) Taxonomy name.

$args

(array|string) (Optional) Array of arguments that get passed to get_terms().

Default value: array()

---

返回值

(array|int|WP_Error) Number of terms in that taxonomy or WP_Error if the taxonomy does not exist.

---

源代码

File: wp-includes/taxonomy.php

function wp_count_terms( $taxonomy, $args = array() ) {
	$defaults = array('hide_empty' => false);
	$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($taxonomy, $args);
}

---

更新日志

Version	description
2.3.0	Introduced.

---

相关函数

Uses

• wp-includes/functions.php: wp_parse_args()
• wp-includes/taxonomy.php: get_terms()

---

Used By

• wp-includes/rest-api/endpoints/class-wp-rest-terms-controller.php: WP_REST_Terms_Controller::get_items()
• wp-admin/includes/class-wp-terms-list-table.php: WP_Terms_List_Table::prepare_items()
• wp-admin/includes/nav-menu.php: wp_nav_menu_item_taxonomy_meta_box()

---

User Contributed Notes