当前浏览:首页 / WordPress函数 / get_tag()

get_tag( int|WP_Term|object $tag, string $output = OBJECT, string $filter = 'raw' )

按标签ID或标签对象检索post标签

tagmore...


描述

如果给$tag参数传递给一个对象(假定该对象是从数据库检索到的标签行对象),它将被缓存。

如果给$tag传递一个整数的标签ID,则将从数据库中检索该标签(如果尚未缓存)并传回。

查看get_term()可以发现,这两个函数都将通过几个过滤器,最后根据$filter参数值进行净化。


参数

$tag

(int|WP_Term|object) (必填) 标签ID或对象。

$output

(string) (可选) 所需的返回类型。OBJECT、ARRAY_A或ARRAY_N中的一个,分别对应于WP_Term对象、关联数组或数字数组。

默认值: OBJECT

$filter

(string) (可选) 如何净化标签字段。

默认值: 'raw'


返回

(WP_Term|array|WP_Error|null) 标签数据的类型由$output参数定义。如果$tag为空,返回WP_Error,如果它不存在,则为null。



源码

查看源码 官方文档


更新日志

版本描述
2.3.0开始引入