| 273 | | * @param string|array $query_vars |
| | 273 | * @param string|array $query_vars { |
| | 274 | * Array or comma-separated list of query parameters. |
| | 275 | * @type string $author_email Optional. Email address of the comment author. |
| | 276 | * @type array $author__in Optional. Array of author IDs to include. |
| | 277 | * @type array $author__not_in Optional. Author IDs to exclude. |
| | 278 | * @type array $include_unapproved Optional. IDs or email addresses of users whose unapproved |
| | 279 | * comments will be returned by the query, regardless of $status. |
| | 280 | * @type string $fields Optional. Comment fields to return. 'ids' for comment IDs only. |
| | 281 | * @type int $ID Currently unused. |
| | 282 | * @type array $comment__in Optional. Array of comment IDs to include. |
| | 283 | * @type array $comment__not_in Optional. Array of comment IDs to exclude. |
| | 284 | * @type int $karma Optional. comment_karma value to match. |
| | 285 | * @type int $number Optional. Max comments to return. Defaults to null (no limit). |
| | 286 | * @type int $offset Optional. Offset used to build LIMIT clause. Defaults to 0. |
| | 287 | * @type string|array $orderby Comment status(es). Accepts 'comment_agent', 'comment_approved', |
| | 288 | * 'comment_author', 'comment_author_email', 'comment_author_IP', |
| | 289 | * 'comment_author_url', 'comment_content', 'comment_date', |
| | 290 | * 'comment_date_gmt', 'comment_ID', 'comment_karma', |
| | 291 | * 'comment_parent', 'comment_post_ID', 'comment_type', 'user_id', |
| | 292 | * 'meta_value', 'meta_value_num', or value of $meta_key. |
| | 293 | * Accepts false, empty array, or 'none' to disable ORDER BY |
| | 294 | * clause. Default: 'comment_date_gmt'. |
| | 295 | * @type string $order Order of returned clauses. Accepts 'ASC', 'DESC'. |
| | 296 | * Default: 'DESC'. |
| | 297 | * @type int $parent Optional. Comment parent. |
| | 298 | * @type array $post_author__in Optional. Return comments limited |
| | 299 | * by ID of affiliated post author. |
| | 300 | * @type array $post_author__not_in Optional. Exclude comments by ID of affiliated post author. |
| | 301 | * @type int $post_ID Currently unused. |
| | 302 | * @type int $post_id Optional. Limit results to those affiliated with a given post. |
| | 303 | * @type array $post__in Optional. Include comments affiliated with an |
| | 304 | * array of post IDs. |
| | 305 | * @type array $post__not_in Optional. Exclude comments affiliated with an |
| | 306 | * array of post IDs. |
| | 307 | * @type int $post_author Optional. Include comments from post by a given author. |
| | 308 | * @type string $post_status Optional. Include comments associated with posts |
| | 309 | * that have a given post_status. |
| | 310 | * @type string $post_type Optional. Include comments associated with posts |
| | 311 | * that have a given post_type. |
| | 312 | * @type string $post_name Optional. Include comments associated with posts |
| | 313 | * that have a given post_name. |
| | 314 | * @type string $post_parent Optional. Include comments associated with posts |
| | 315 | * that have a given post_parent. |
| | 316 | * @type string $status Include comments with a given status. Accepts |
| | 317 | * 'hold' (comment_status=0), 'approve' (comment_status=1), 'all', |
| | 318 | * or a custom comment status. |
| | 319 | * @type string $type Optional. Include comments of a given type. Accepts 'comment', |
| | 320 | * 'pings' (includes 'pingback' and 'trackback') or any |
| | 321 | * custom type string. |
| | 322 | * @type int $user_id Optional. Include comments by a specific user. |
| | 323 | * @type string $search Optional. Include comments matching a search string. |
| | 324 | * @type bool $count True to return a comment count, false to return an array of |
| | 325 | * comment objects. Default: false. |
| | 326 | * @type string $meta_key Optional. Include comments with commentmeta matching a |
| | 327 | * given meta_key. |
| | 328 | * @type string $meta_value Optional. Include comments with commentmeta matching a |
| | 329 | * given meta_value. Can be used with $meta_key. |
| | 330 | * @type array $meta_query An array of meta query clauses. See {@link WP_Meta_Query}. |
| | 331 | * @type array $date_query An array of date query clauses. See {@link WP_Date_Query}. |
| | 332 | * } |