1. 首页
  2. WordPress 函数手册

get_taxonomies()

get_taxonomies( array $args = array(), string $output = ‘names’, string $operator = ‘and’ )

检索已注册的分类法名称或对象的列表。
Retrieves a list of registered taxonomy names or objects.

目录锚点:#参数#返回#源码#笔记


参数(Parameters)

参数 类型 必填 说明
$args (array) 可选 要与分类对象匹配的key=>值参数数组。
$output (string) 可选 要在数组中返回的输出类型。接受分类法“名称”或“对象”。
$operator (string) 可选 要执行的逻辑操作。接受“and”或“or”或者’表示数组中只有一个元素需要匹配;’和’表示所有元素都必须匹配。

返回(Return)

(string[]|WP_Taxonomy[])分类法名称或对象的数组。


源码(Source)

/**
 * Retrieves a list of registered taxonomy names or objects.
 *
 * @since 3.0.0
 *
 * @global array $wp_taxonomies The registered taxonomies.
 *
 * @param array  $args     Optional. An array of `key => value` arguments to match against the taxonomy objects.
 *                         Default empty array.
 * @param string $output   Optional. The type of output to return in the array. Accepts either taxonomy 'names'
 *                         or 'objects'. Default 'names'.
 * @param string $operator Optional. The logical operation to perform. Accepts 'and' or 'or'. 'or' means only
 *                         one element from the array needs to match; 'and' means all elements must match.
 *                         Default 'and'.
 * @return array A list of taxonomy names or objects.
 */
function get_taxonomies( $args = array(), $output = 'names', $operator = 'and' ) {
	global $wp_taxonomies;

	$field = ('names' == $output) ? 'name' : false;

	return wp_filter_object_list($wp_taxonomies, $args, $operator, $field);
}
更新版本 源码位置 使用 被使用
3.0.0 wp-includes/taxonomy.php:193 16 1 function

笔记(Notes)

在本例中,当查询具有特定post类型(如“posts”)的分类法时,将仅显示仅与此post类型连接的分类法。如果一个分类法附加到多个post类型,它将不会被列出。核心Trac票27918
仅显示公共自定义分类的列表-不会列出包含WordPress内置分类的列表(例如,类别和标记):
显示特定分类法的复数名称(并将输出设置为“object”,而不是默认的“array”):

get_taxonomies() 为WP2原创文章,链接:https://www.wp2.cn/functions/get_taxonomies/

发表评论

邮箱地址不会被公开。