get_tags()获取标签数组

功能:

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

<?php $tags_array = get_tags( $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”的值为首,不区分大小写。默认值为空字符串。

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()

(完)

版权声明WordPress头条正在使用WordPress文章版权插件
如未注明,均为原创,转载需注明出处
本文链接地址:http://www.wptoutiao.com/functions/157.html

文章标签的相关文章

标签管理的相关文章

还可以分享文章给好友:

发表评论

电子邮件地址不会被公开。 必填项已用*标注