| [ Index ] |
PHP Cross Reference of WordPress |
[Source view] [Print] [Project Stats]
Comment API: WP_Comment_Query class
| File Size: | 1234 lines (48 kb) |
| Included or required: | 0 times |
| Referenced: | 0 times |
| Includes or requires: | 0 files |
WP_Comment_Query:: (11 methods):
__call()
__construct()
parse_query()
query()
get_comments()
get_comment_ids()
set_found_comments()
fill_descendants()
get_search_sql()
parse_orderby()
parse_order()
Class: WP_Comment_Query - X-Ref
Core class used for querying comments.| __call( $name, $arguments ) X-Ref |
| Make private/protected methods readable for backward compatibility. param: string $name Method to call. param: array $arguments Arguments to pass when calling. return: mixed|false Return value of the callback, false otherwise. since: 4.0.0 |
| __construct( $query = '' ) X-Ref |
| Constructor. Sets up the comment query, based on the query vars passed. param: string|array $query { since: 4.2.0 since: 4.4.0 `$parent__in` and `$parent__not_in` were added. since: 4.4.0 Order by `comment__in` was added. `$update_comment_meta_cache`, `$no_found_rows`, since: 4.5.0 Introduced the `$author_url` argument. since: 4.6.0 Introduced the `$cache_domain` argument. since: 4.9.0 Introduced the `$paged` argument. since: 5.1.0 Introduced the `$meta_compare_key` argument. since: 5.3.0 Introduced the `$meta_type_key` argument. |
| parse_query( $query = '' ) X-Ref |
| Parse arguments passed to the comment query with default query parameters. param: string|array $query WP_Comment_Query arguments. See WP_Comment_Query::__construct() since: 4.2.0 Extracted from WP_Comment_Query::query(). |
| query( $query ) X-Ref |
| Sets up the WordPress query for retrieving comments. param: string|array $query 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. since: 3.1.0 since: 4.1.0 Introduced 'comment__in', 'comment__not_in', 'post_author__in', since: 4.2.0 Moved parsing to WP_Comment_Query::parse_query(). |
| get_comments() X-Ref |
| Get a list of comments matching the query vars. return: int|int[]|WP_Comment[] List of comments or number of found comments if `$count` argument is true. since: 4.2.0 |
| get_comment_ids() X-Ref |
| Used internally to get a list of comment IDs matching the query vars. return: int|array A single count of comment IDs if a count query. An array of comment IDs if a full query. since: 4.4.0 |
| set_found_comments() X-Ref |
| Populates found_comments and max_num_pages properties for the current query if the limit clause was used. since: 4.6.0 |
| fill_descendants( $comments ) X-Ref |
| Fetch descendants for located comments. Instead of calling `get_children()` separately on each child comment, we do a single set of queries to fetch the descendant trees for all matched top-level comments. param: WP_Comment[] $comments Array of top-level comments whose descendants should be filled in. return: array since: 4.4.0 |
| get_search_sql( $search, $columns ) X-Ref |
| Used internally to generate an SQL string for searching across multiple columns. param: string $search Search string. param: string[] $columns Array of columns to search. return: string Search SQL. since: 3.1.0 |
| parse_orderby( $orderby ) X-Ref |
| Parse and sanitize 'orderby' keys passed to the comment query. param: string $orderby Alias for the field to order by. return: string|false Value to used in the ORDER clause. False otherwise. since: 4.2.0 |
| parse_order( $order ) X-Ref |
| Parse an 'order' query variable and cast it to ASC or DESC as necessary. param: string $order The 'order' query variable. return: string The sanitized 'order' query variable. since: 4.2.0 |
| Generated: Sun Dec 22 01:00:02 2024 | Cross-referenced by PHPXref 0.7.1 |