posts_clauses
Filters all query clauses at once, for convenience.
Covers the WHERE, GROUP BY, JOIN, ORDER BY, DISTINCT, fields (SELECT), and LIMIT clauses.
Использование
add_filter( 'posts_clauses', 'wp_kama_posts_clauses_filter', 10, 2 ); /** * Function for `posts_clauses` filter-hook. * * @param string[] $clauses Associative array of the clauses for the query. * @param WP_Query $query The WP_Query instance (passed by reference). * * @return string[] */ function wp_kama_posts_clauses_filter( $clauses, $query ){ // filter... return $clauses; }
- $clauses(string[])
Associative array of the clauses for the query.
-
where(строка)
The WHERE clause of the query. -
groupby(строка)
The GROUP BY clause of the query. -
join(строка)
The JOIN clause of the query. -
orderby(строка)
The ORDER BY clause of the query. -
distinct(строка)
The DISTINCT clause of the query. -
fields(строка)
The SELECT clause of the query. - limits(строка)
The LIMIT clause of the query.
-
- $query(WP_Query)
- The WP_Query instance (passed by reference).
Список изменений
С версии 3.1.0 | Введена. |
Где вызывается хук
posts_clauses
wp-includes/class-wp-query.php 2859
$clauses = (array) apply_filters_ref_array( 'posts_clauses', array( compact( $pieces ), &$this ) );
Где используется хук в WordPress
wp-admin/includes/ajax-actions.php 2997
add_filter( 'posts_clauses', '_filter_query_attachment_filenames' );
wp-admin/includes/post.php 1305
add_filter( 'posts_clauses', '_filter_query_attachment_filenames' );
wp-includes/post.php 7935
remove_filter( 'posts_clauses', __FUNCTION__ );
wp-includes/rest-api/endpoints/class-wp-rest-attachments-controller.php 100
add_filter( 'posts_clauses', '_filter_query_attachment_filenames' );