posts_join │ filter-hook │ WP 1.5.0

Filters the JOIN clause of the query.

Usage

add_filter( 'posts_join', 'wp_kama_posts_join_filter', 10, 2 );

/**
 * Function for `posts_join` filter-hook.
 * 
 * @param string   $join  The JOIN clause of the query.
 * @param WP_Query $query The WP_Query instance (passed by reference).
 *
 * @return string
 */
function wp_kama_posts_join_filter( $join, $query ){

	// filter...
	return $join;
}

$join(string)

The JOIN clause of the query.

$query(WP_Query)

The WP_Query instance (passed by reference).

Changelog

Where the hook is called

$join = apply_filters_ref_array( 'posts_join', array( $join, &$this ) );

Where the hook is used in WordPress