get_{$adjacent}_post_join WordPress Filter Hook

The get_{$adjacent}_post_join hook is called during SQL query for the next/previous post. This hook is giving developers the chance to alter the SQL JOIN clause used in the query, which can be useful for optimizing performance.

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

Filters the JOIN 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_join
get_previous_post_join

Top ↑

Parameters

$join: (string)The JOIN 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.