函数介绍
查找文章标签并输出一个对象数组
函数用法
<?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)
评论抢沙发