posts_clauses filter-hook . WP 3.1.0

Filters all query clauses at once, for convenience.

Covers the WHERE, GROUP BY, JOIN, ORDER BY, DISTINCT, fields (SELECT), and LIMITS clauses.

Usage

add_filter( 'posts_clauses', 'filter_function_name_1245', 10, 2 );
function filter_function_name_1245( $clauses, $this ){
	// filter...

	return $clauses;
}

$clauses(string[])

Associative array of the clauses for the query.

$this(WP_Query)

The WP_Query instance (passed by reference).

Changelog

Where the hook is called

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

Where the hook is used (in WP core)

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' );