get_{$adjacent}_post_where WordPress Filter Hook

The get_{$adjacent}_post_where hook is used to modify the SQL WHERE clause in the get_{$adjacent}_post() function. This can be used to change the default behavior of the function, for example, to only return posts from the same category as the current post.

apply_filters( "get_{$adjacent}_post_where", string $where, bool $in_same_term, array $excluded_terms, string $taxonomy, WP_Post $post ) #

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

Description
Parameters
Source
Related
- Used By
Changelog

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

Top ↑

Parameters

$where: (string)The WHERE clause in the SQL.
$in_same_term: (bool)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.