WordPress 函数：get_comments 评论查询 参数大全

在 WordPress 中，get_comments 负责评论查询，其功能强大，参数负责，值得重点学习一下。

其参数如下：

author_email string

作者电子邮件地址

author_url string

作者URL

author__in int[]

作者ID数组

author__not_in int[]

需要排除的作者ID数组

comment__in int[]

评论ID数组

comment__not_in int[]

需要排除的评论ID数组

count bool

true 则只返回数量，默认false

fields string

Comment fields to return. Accepts 'ids' for comment IDs only or empty for all fields.

只接受 'ids' 或 ''，'ids'只返回ID，''返回所有字段

include_unapproved array

评论ID数组 或 用户email数组，未批准的评论也会返回

karma int

Karma score to retrieve matching comments for.（这说的是啥？）

meta_key string|string[]

附加属性键。

meta_value string|string[]

附加属性值。

meta_compare string

附加属性比较符号。支持MySQL操作符。参考：WP_Meta_Query::__construct()。

meta_compare_key string

附加属性的key，支持MySQL关键字，参考：See WP_Meta_Query::__construct() 。

meta_type string

附加属性的值类型，参考：WP_Meta_Query::__construct()。

meta_type_key string

附加属性的值类型的key，参考：WP_Meta_Query::__construct()。

meta_query array

附加属性查询数组，参考：WP_Meta_Query::__construct()。

number int

数量限制。默认无限制。

paged int

与$number一起使用时，定义要返回的结果页。与$offset一起使用时，$offset优先。默认值1。

offset int

要偏移查询的评论数。用于生成LIMIT子句。默认值为0。

no_found_rows bool

是否禁用SQL_CALC_FOUND_ROWS查询。默认值：true。

orderby string|array

评论状态或状态数组。要使用“meta_value”或“meta_vvalue_num”，还必须定义$meta_key。要按特定的$meta_query子句排序，请使用该子句的数组键。接受：

'comment_agent'

'comment_approved'

'comment_author'

'comment_author_email'

'comment_author_IP'

'comment_author_url'

'comment_content'

'comment_date'

'comment_date_gmt'

'comment_ID'

'comment_karma'

'comment_parent'

'comment_post_ID'

'comment_type'

'user_id'

'comment__in'

'meta_value'

'meta_value_num'

The value of $meta_key

The array keys of $meta_query

false, an empty array, or 'none' to disable ORDER BY clause.

Default: 'comment_date_gmt'.

order string

如何排序检索到的评论。接受“ASC”、“DESC”。默认值：“DESC”。

parent int

要检索其子级的评论的父ID。

parent__in int[]

要检索其子级的评论的父ID数组。

parent__not_in int[]

要为其检索子级的评论*而非*的父ID数组。

post_author__in int[]

要为其检索评论的作者ID数组。

post_author__not_in int[]

要检索其评论的作者ID数组*不*。

post_id int

将结果限制为与给定帖子ID关联的结果。默认值为0。

post__in int[]

包含附属评论的帖子ID数组。

post__not_in int[]

要排除其关联评论的帖子ID数组。

post_author int

发布作者ID以限制结果。

post_status string|string[]

要检索其关联评论的帖子状态或帖子状态数组。传递“any”以匹配任何值。

post_type string|string[]

要检索其附属评论的文章类型或文章类型数组。传递“any”以匹配任何值。

post_name string

要检索其关联评论的帖子名称。

post_parent int

发布父ID以检索其附属评论。

search string

要检索其匹配评论的搜索项。

status string|array

限制结果的评论状态。接受“保持”（Comment_status=0）、“批准”（Comment _status=1）、“全部”或自定义评论状态的数组或空格/逗号分隔列表。默认为“all”。

type string|string[]

包括给定类型或类型数组的评论。

接受“comment”、“ping”（包括“pingback”和“trackback”）或任何自定义类型字符串。

type__in string[]

包括来自给定评论类型数组的评论。

type__not_in string[]

从给定的评论类型数组中排除评论。

user_id int

包括特定用户ID的评论。

hierarchical bool|string

是否在结果中包含评论子体。“thread”返回一个树，每个评论的子级存储在WP_comment对象的children属性中。“flat”返回找到的评论及其子项的平面数组。布尔值为false时会忽略后代。当$fields为“ids”或“counts”时，将忽略该参数（强制为false）。接受“thread”、“flat”或false。默认值：false。

cache_domain string

将此查询存储在对象缓存中时要生成的唯一缓存键。默认值为“core”。

update_comment_meta_cache布尔值

是否为找到的评论填充元数据缓存。默认为true。

update_comment_post_cache bool

是否为评论文章填充缓存。默认值为false。