WordPress获取标签信息函数：get_tags

WordPress函数get_tags用于获取标签对象。

get_tags( string|array $args = \'\' )

函数参数

$args

数组或字符串，可用值如下。

taxonomy

字符串，默认值：post_tag

分类法名称

object_ids

整数或数组

对应于wp_term_relationships表object_id字段，该字段对应于wp_posts表的ID，也就是指定文章的ID

orderby

字符串，默认值：name

排序的参照标准，可用值如下：

• terms字段：name、slug、term_group、term_id、id、description、parent、term_order；
• count：按文章数排序；
• include：匹配include参数；
• slug__in：匹配slug参数；
• meta_value/meta_value_num：按照termmeta表中meta_value字段值排序，需指定meta_key参数；

order

字符串，默认值：ASC

排序的方式，可用值如下：

• ASC：默认值，以升序排列；
• DESC：降序排列；

hide_empty

布尔值，默认值：true

是否隐藏没有文章的标签

include

数组或字符串

要包含的标签ID

exclude

数组或字符串

要排除的标签ID

number

整数

返回的标签数量

offset

整数

查询偏移量

fields

字符串

要查询的terms字段，指定字段后将只返回指定字段值

• all：返回包含所有WP_Term Object的数组；
• all_with_object_id：测试中没有发现与all有区别；
• ids：仅返回标签的ID；
• tt_ids：返回term_taxonomy_id，一般情况下与term_id的值是相同的；
• names：仅返回标签的名称；
• slugs：仅返回标签的别名；
• count：返回查询到的标签总数；
• id=>name：以ID为键，返回标签名称；
• id=>slug：以ID为键，返回标签别名；

count

布尔值，默认值：false

返回标签文章数量，优先于fields的设置，实际测试没有任何效果。

name

字符串

指定标签的名称，则返回该标签对象

slug

字符串

指定标签别名，则返回该标签对象

term_taxonomy_id

整数

根据指定的分类法ID返回数据

search

字符串

搜索匹配条件的标签

name__like

字符串

返回名称中包含指定关键词的标签

description__like

字符串

返回描述中包含指定关键词的标签

cache_domain

字符串，默认值：core

指定对象缓存的Key

update_term_meta_cache

布尔值，默认值：true

meta_query

数组

元数据查询

meta_key

字符串

元数据键的名称

meta_value

字符串

元数据键的值

meta_type

字符串

meta_compare

字符串

meta_value的比较运算符

函数返回值

Array(    [0] => WP_Term Object        (            [term_id] => 10            [name] => 建站教程            [slug] => site-tutorial            [term_group] => 0            [term_taxonomy_id] => 10            [taxonomy] => post_tag            [description] =>             [parent] => 0            [count] => 11            [filter] => raw        )    [1] => WP_Term Object        (            [term_id] => 11            [name] => 互联网            [slug] => internet            [term_group] => 0            [term_taxonomy_id] => 11            [taxonomy] => post_tag            [description] =>             [parent] => 0            [count] => 1            [filter] => raw        ))

函数使用示例

$args = array(\'hide_empty\' => false,);$tags = get_tags($args);$html = \'<div >\';foreach($tags as $tag) {    $tag_link = get_tag_link($tag->term_id);           $html .= \'<a href=\"\' . $tag_link .\'\" title=\"\' . $tag->name. \'\" >\';    $html .= $tag->name . \'</a>\';}$html .= \'</div>\';echo $html;

扩展阅读

get_tags()函数位于：wp-includes/category.php

相关函数：

• get_terms()
• get_categories()