apply_filters_ref_array( 'posts_clauses', string[] $clauses, WP_Query $query )

Description

Compatibility

Present in every tracked release (6.7.7 to 7.1.0).

Parameters

$clausesstring[]

{ Associative array of the clauses for the query.
@type string $where The WHERE clause of the query.
@type string $groupby The GROUP BY clause of the query.
@type string $join The JOIN clause of the query.
@type string $orderby The ORDER BY clause of the query.
@type string $distinct The DISTINCT clause of the query.
@type string $fields The SELECT clause of the query.
@type string $limits The LIMIT clause of the query.
}

• $wherestring

  The WHERE clause of the query.

• $groupbystring

  The GROUP BY clause of the query.

• $joinstring

  The JOIN clause of the query.

• $orderbystring

  The ORDER BY clause of the query.

• $distinctstring

  The DISTINCT clause of the query.

• $fieldsstring

  The SELECT clause of the query.

• $limitsstring

  The LIMIT clause of the query.

$queryWP_Query

The WP_Query instance (passed by reference).

Where this hook fires · 1

• wp-includes/class-wp-query.php:3024WP_Query::get_posts()

Source code

View on Trac ↗View on GitHub ↗

3018			 *     @type string $distinct The DISTINCT clause of the query.3019			 *     @type string $fields   The SELECT clause of the query.3020			 *     @type string $limits   The LIMIT clause of the query.3021			 * }3022			 * @param WP_Query $query   The WP_Query instance (passed by reference).3023			 */3024			$clauses = (array) apply_filters_ref_array( 'posts_clauses', array( compact( $pieces ), &$this ) );3025 3026			$where    = isset( $clauses['where'] ) ? $clauses['where'] : '';3027			$groupby  = isset( $clauses['groupby'] ) ? $clauses['groupby'] : '';3028			$join     = isset( $clauses['join'] ) ? $clauses['join'] : '';3029			$orderby  = isset( $clauses['orderby'] ) ? $clauses['orderby'] : '';3030			$distinct = isset( $clauses['distinct'] ) ? $clauses['distinct'] : '';

Changelog

Introduced in 3.1.0. Unchanged from 6.7.7 through 7.1.0.

1. 6.7.7
2. 6.8.8
3. 6.9.7
4. 7.0.4
5. 7.1.0

Signature, return type and hooks compared across 5 parsed releases.

About this page

Parsed data

Generated from the wordpress-develop 6.9.7 tag, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.

Corrections

Something wrong on this page? Report it and it gets fixed in the next regeneration.