apply_filters_ref_array( 'posts_distinct', string $distinct, WP_Query $query )

Filters the DISTINCT clause of the query.

Contents

Parameters
More Information
Source
Related
- Used By
Changelog
User Contributed Notes

Parameters

$distinct string: The DISTINCT clause of the query.
$query WP_Query: The WP_Query instance (passed by reference).

More Information

Returning “DISTINCTROW” from the filter has the same effect on the query as “DISTINCT”.

Source

File: wp-includes/class-wp-query.php. View all references

$distinct = apply_filters_ref_array( 'posts_distinct', array( $distinct, &$this ) );

View on Trac View on GitHub

Used By

Used By
Used By	Description
WP_Query::get_posts() wp-includes/class-wp-query.php	Retrieves an array of posts based on query variables.

Changelog

Changelog
Version	Description
2.1.0	Introduced.

User Contributed Notes

Skip to note 1 content

You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note

Contributed by Steven Lin — 2 years ago
Example Migrated from Codex:

Eliminate duplicates in posts returned, unless the duplicates is allowed
```
add_filter('posts_distinct', 'search_distinct');

function search_distinct() {
	if ( $this->allow_duplicates )
		return ""; // filter has no effect
	return "DISTINCT";
}
```
Log in to add feedback

You must log in before being able to contribute a note or feedback.