From fafc699116b6af693ad2da3e6d7be771b573332b Mon Sep 17 00:00:00 2001 From: Benito Alba Molina <272526523+benitoalba@users.noreply.github.com> Date: Sun, 25 Oct 2026 23:39:33 +0100 Subject: [PATCH] Docs: Clarify comment query status values. --- src/wp-includes/class-wp-comment-query.php | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/src/wp-includes/class-wp-comment-query.php b/src/wp-includes/class-wp-comment-query.php index 76367e43ee08a..155665efbdded 100644 --- a/src/wp-includes/class-wp-comment-query.php +++ b/src/wp-includes/class-wp-comment-query.php @@ -247,9 +247,10 @@ public function __call( $name, $arguments ) { * @type string $search Search term(s) to retrieve matching comments for. * Default empty. * @type string|array $status Comment statuses to limit results by. Accepts an array - * or space/comma-separated list of 'hold' (`comment_status=0`), - * 'approve' (`comment_status=1`), 'all', or a custom - * comment status. Default 'all'. + * or space/comma-separated list of 'hold' (`comment_approved=0`), + * 'approve' (`comment_approved=1`), 'all' (approved and pending), + * 'any' (all statuses, including spam and trash), or a custom + * comment status. 'any' overrides other statuses. Default 'all'. * @type string|string[] $type Include comments of a given type, or array of types. * Accepts 'comment', 'pings' (includes 'pingback' and * 'trackback'), or any custom type string. Default empty.