get_tag

函数
get_tag ( $tag, $output = OBJECT, $filter = 'raw' )
参数
  • (int|WP_Term|object) $tag A tag ID or object.
    Required:
  • (string) $output Optional. The required return type. One of OBJECT, ARRAY_A, or ARRAY_N, which correspond to a WP_Term object, an associative array, or a numeric array, respectively. Default OBJECT.
    Required:
    Default: OBJECT
  • (string) $filter Optional. How to sanitize tag fields. Default 'raw'.
    Required:
    Default: 'raw'
返回值
  • (WP_Term|array|WP_Error|null) Tag data in type defined by $output parameter. WP_Error if $tag is empty, null if it does not exist.
定义位置
相关方法
get_tagsget_pageget_pagesget_tag_linkget_the_tags
引入
2.3.0
弃用
-

get_tag: 这个函数通过ID检索一个特定的标签对象。它接受一个参数:要检索的标签的ID。它返回标签对象。

通过标签ID或标签对象检索一个文章标签。

如果你传递给$tag参数一个对象,它被认为是从数据库中检索的标签行对象,它将缓存标签数据。

如果你传给$tag一个标签ID的整数,那么这个标签将被从数据库中检索出来,如果它还没有被缓存的话,并传回。

如果你看一下get_term(),这两种类型都会通过几个过滤器,最后根据$filter的参数值进行净化处理。

function get_tag( $tag, $output = OBJECT, $filter = 'raw' ) {
	return get_term( $tag, 'post_tag', $output, $filter );
}

常见问题

FAQs
查看更多 >