get_taxonomies()
get_taxonomies( array $args = array(), string $output =…
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”):
类别:WordPress 函数手册、
本文收集自互联网,转载请注明来源。
如有侵权,请联系 wper_net@163.com 删除。
还没有任何评论,赶紧来占个楼吧!