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

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

Parameters

$joinstring
The JOIN 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

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

Changelog

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

User Contributed Notes

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