apply_filters_ref_array( 'posts_join', string $join, WP_Query $query )

Filters the JOIN clause of the query.

Parameters

$join

(string) The JOIN clause of the query.

$query

(WP_Query) The WP_Query instance (passed by reference).

More Information

When you use the wp_query object to run a query, not all tables are queried by default. For example, a query on the blog archive will only query the posts table. If you wanted to display posts that have specific meta value you will have to alter the wp_query object to include the required meta key.

Source

File: wp-includes/class-wp-query.php

View on Trac

Used By

Used By Description
wp-includes/class-wp-query.php: WP_Query::get_posts()

Retrieves an array of posts based on query variables.

Changelog

Version Description
1.5.0 Introduced.

© 2003–2021 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/hooks/posts_join