get_tags()

WordPress获取标签信息函数

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 class="post_tags">';
foreach($tags as $tag) {
    $tag_link = get_tag_link($tag->term_id);       
    $html .= '<a href="' . $tag_link .'" title="' . $tag->name. '" class="'. $tag->slug . '">';
    $html .= $tag->name . '</a>';
}
$html .= '</div>';
echo $html;

扩展阅读

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