【函数介绍】

在每项文章标签的分类系统中检索一个对象数组

【函数用法】

<?php get_tags()  ?>

【参数】

该函数取自 get_terms的taxonomy.php文件中的notes，并做了轻度更改，函数取决于：

根据$args定义的标准来检索文章标签列表。以下是$args中的变量列表，这些变量可改写默认值：

orderby — 默认值为’name’。可以是名称，计数或空（使用term_id）。

order — 默认值ASC。有效值还包括DESC。

hide_empty — 默认值为true。不返回空条件，根据已知分类法，空条件的计数为0。

exclude — 默认值是一个空字符串。若条件编号的字符串由逗号或空格界定，条件编号将从返回的数组中被删除。’include’非空时忽略’exclude’。

include — 默认值是一个空字符串。若条件编号的字符串由逗号或空格界定，返回的数组中将包括条件编号。

number — 将要返回的条件的最大数量。默认值为空。

offset — 用以抵消条件查询的数字

fields — 默认值为”all”，返回条件对象数组。若’fields’是’ids’或’names’，分别返回整数数组或字符串数组。

slug — 返回条件的缩略名应与该值相匹配。默认值为空字符串。

hierarchical — 是否应包含其后代非空的条件（即使’hide_empty’为true）

search — 返回的条件名称应含有’search’值，不区分大小写。默认值为空字符串。

name_like — 返回的条件名称应以”name_like”的值为首，不区分大小写。默认值为空字符串。

变量’pad_counts’，设为true时返回的值应包括条件的’count’对象变量总数中条件子的数量。

变量’get’，值设为’all’而不是默认空字符串时，返回条件，无论其上级如何或是否为空。

使用变量’child_of’时应将变量值设为条件编号的整数。默认值为0。根据已知分类法，值设为非零时，所有返回的条件都将成为该编号的条件的后代。若$taxonomies传递一个以上分类，’child_of’被设为0，因为多个分类会使条件上级不明确。

使用变量’parent’时应将变量值设为条件编号的整数。默认值为空字符串，与整数0含义有所不同。根据已知分类法，值为整数时，所有返回的条件都会将指定编号的条件作为上级。’parent’变量与’child_of’的不同之处在于，只有在条件X是条件Y的父级，而不是祖父或者曾祖父级时，条件X才可以被成为条件Y的’parent’（‘父级’）。

【返回值】

每个返回对象具有以下数据

term_id
(string)
name
(string)
slug
(string)
term_group
(string)
term_taxonomy_id
(string)
taxonomy
(string)
description
(string)
parent
(string)
count
(string)

【示例】

//获取标签，并显示带链接标签列表:
$tags = get_tags();
$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} Tag' class='{$tag->slug}'>";
	$html .= "{$tag->name}</a>";
}
$html .= '</div>';
echo $html;

【源代码】

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