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

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

$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.

Source

File: wp-includes/link-template.php

View on Trac

Used By

Used By Description
wp-includes/link-template.php: get_adjacent_post()

Retrieves the adjacent post.

Changelog

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

© 2003–2021 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/hooks/get_adjacent_post_join