get_(adjacent)_post_join filter-hook . WP 2.5.0

Filters the JOIN clause in the SQL for an adjacent post query.

The dynamic portion of the hook name, $adjacent, refers to the type of adjacency, 'next' or 'previous'.

Usage

add_filter( 'get_(adjacent)_post_join', 'filter_function_name_1297', 10, 5 );
function filter_function_name_1297( $join, $in_same_term, $excluded_terms, $taxonomy, $post ){
	// filter...

	return $join;
}

$join(string)

The JOIN clause in the SQL.

$in_same_term(true/false)

Whether post should be in a same taxonomy term.

$excluded_terms(array)

Array of excluded term IDs.

$taxonomy(string)

Taxonomy. Used to identify the term used when $in_same_term is true.

$post(WP_Post)

WP_Post object.

Notes

• Since 4.4.0 Added the $taxonomy and $post parameters.

Where the hook is called

$join = apply_filters( "get_{$adjacent}_post_join", $join, $in_same_term, $excluded_terms, $taxonomy, $post );

Where the hook is used (in WP core)