posts_clauses │ хук-фильтр │ WP 3.1.0

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).

Список изменений

Где вызывается хук

$clauses = (array) apply_filters_ref_array( 'posts_clauses', array( compact( $pieces ), &$this ) );

Где используется хук в WordPress

add_filter( 'posts_clauses', '_filter_query_attachment_filenames' );

add_filter( 'posts_clauses', '_filter_query_attachment_filenames' );

remove_filter( 'posts_clauses', __FUNCTION__ );

add_filter( 'posts_clauses', '_filter_query_attachment_filenames' );