WordPress at Your Fingertips
filter is not described

get_(adjacent)_post_where filter-hook . WP 2.5.0

Filters the WHERE 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'.

Possible hook names include:

  • get_next_post_where
  • get_previous_post_where


add_filter( 'get_(adjacent)_post_where', 'filter_function_name_1420', 10, 5 );
function filter_function_name_1420( $where, $in_same_term, $excluded_terms, $taxonomy, $post ){
	// filter...

	return $where;
The WHERE clause in the SQL.
Whether post should be in a same taxonomy term.
Array of excluded term IDs.
Taxonomy. Used to identify the term used when $in_same_term is true.
WP_Post object.


Since 2.5.0 Introduced.
Since 4.4.0 Added the $taxonomy and $post parameters.

Where the hook is called

wp-includes/link-template.php 1932
$where = apply_filters( "get_{$adjacent}_post_where", $wpdb->prepare( "WHERE p.post_date $op %s AND p.post_type = %s $where", $current_post_date, $post->post_type ), $in_same_term, $excluded_terms, $taxonomy, $post );

Where in WP core the hook is used WordPress

Usage not found.