get_tags()获取标签数组

功能：

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

参数：

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”的值为首，不区分大小写。默认值为空字符串。

description__like — 返回的条件描述中包含 ‘description__like’, 不区分大小写。 默认为空字符串。

pad_counts — 如果设置为true，则将每个术语的“计数”对象变量的数量包含一个术语的子项的数量。

get – 如果将其设置为“ALL”而不是默认的空字符串，则返回术语，而不考虑祖先或术语是否为空。

child_of – 使用时，应将其设置为id id的整数。其默认值是0。如果设置为非零值，则所有返回的术语将根据给定的分类法作为该术语的后代。因此，“child_of”如果有一个以上的分类，通过分类设置为0美元，由于多个分类项血统的暧昧。

parent – 使用时，应将其设置为一个整数id的整数。它的默认值是空字符串，它与整数0有不同的含义。如果将其设置为整数值，则所有返回的术语都将具有一个直接祖先，该术语的ID是根据给定的分类法由该整数指定的。“家长”的说法是从不同的child_of在一个学期的X是一个父母长期Y只有项X是Y的父亲长期，而不是它的祖父或者曾祖父，等。

返回值：

(array)
返回标签列表数组

所在位置：

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

源码：

/**
 * Retrieves all post tags.
 *
 * @since 2.3.0
 * @see get_terms() For list of arguments to pass.
 *
 * @param string|array $args Tag arguments to use when retrieving tags.
 * @return array List of tags.
 */
function get_tags( $args = '' ) {
	$tags = get_terms( 'post_tag', $args );

	if ( empty( $tags ) ) {
		$return = array();
		return $return;
	}

	/**
	 * Filters the array of term objects returned for the 'post_tag' taxonomy.
	 *
	 * @since 2.3.0
	 *
	 * @param array $tags Array of 'post_tag' term objects.
	 * @param array $args An array of arguments. @see get_terms()
	 */
	$tags = apply_filters( 'get_tags', $tags, $args );
	return $tags;
}

示例：

$t = get_tags();
print_r($t);

相关函数:

get_terms()