comments_template_query_args

查看官方原文 ↗

💡 云策文档标注

概述

本文档介绍了 comments_template_query_args 过滤器，用于在 comments_template() 函数中修改查询评论的参数。这些参数基于 WP_Comment_Query 类，允许开发者自定义评论查询行为。

$comment_args = apply_filters( 'comments_template_query_args', $comment_args );

📄 原文内容

Filters the arguments used to query comments in comments_template() .

$comment_argsarray

Array of WP_Comment_Query arguments.

orderby string|array
Field(s) to order by.
order string
Order of results. Accepts 'ASC' or 'DESC'.
status string
Comment status.
include_unapproved array
Array of IDs or email addresses whose unapproved comments will be included in results.
post_id int
ID of the post.
no_found_rows bool
Whether to refrain from querying for found rows.
update_comment_meta_cache bool
Whether to prime cache for comment meta.
hierarchical bool|string
Whether to query for comments hierarchically.
offset int
Comment offset.
number int
Number of comments to fetch.

$comment_args = apply_filters( 'comments_template_query_args', $comment_args );

Used by	Description
comments_template()`wp-includes/comment-template.php`	Loads the comment template specified in $file.

Version	Description
4.5.0	Introduced.