WP_Comment_Query::query() WordPress Method
The query() method is used to query the database for comments. The method accepts an array of arguments, which are used to narrow the search. Comments can be retrieved by post ID, author, status, type, parent, and more.
WP_Comment_Query::query( string|array $query ) #
Sets up the WordPress query for retrieving comments.
Parameters
- $query
(string|array)(Required)Array or URL query string of parameters.
Return
(array|int) List of comments, or number of comments when 'count' is passed as a query var.
Source
File: wp-includes/class-wp-comment-query.php
public function query( $query ) {
$this->query_vars = wp_parse_args( $query );
return $this->get_comments();
}
Expand full source codeCollapse full source codeView on TracView on GitHub
Changelog
| Version | Description |
|---|---|
| 4.2.0 | Moved parsing to WP_Comment_Query::parse_query(). |
| 4.1.0 | Introduced 'comment__in', 'comment__not_in', 'post_author__in', 'post_author__not_in', 'author__in', 'author__not_in', 'post__in', 'post__not_in', 'include_unapproved', 'type__in', and 'type__not_in' arguments to $query_vars. |
| 3.1.0 | Introduced. |