get_{$adjacent}_post_where – Hook | Developer.WordPress.org

apply_filters( “get_{$adjacent}_post_where”, string $where, bool $in_same_term, int[]|string $excluded_terms, string $taxonomy, WP_Post $post )

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

Description

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

Parameters

$wherestring: The WHERE clause in the SQL.
$in_same_termbool: Whether post should be in the same taxonomy term.
$excluded_termsint[]|string: Array of excluded term IDs. Empty string if none were provided.
$taxonomystring: Taxonomy. Used to identify the term used when $in_same_term is true.
$postWP_Post: WP_Post object.

Source

$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 );

View all references View on Trac View on GitHub

Used by	Description
get_adjacent_post()`wp-includes/link-template.php`	Retrieves the adjacent post.

Changelog

Version	Description
4.4.0	Added the `$taxonomy` and `$post` parameters.
2.5.0	Introduced.

User Contributed Notes

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