A WordPress-centric search engine for devs and theme authors

get_{$adjacent}_post_join › WordPress Filter Hooks

apply_filters( "get_{$adjacent}_post_join", $join, $in_same_term, $excluded_terms, $taxonomy, $post )
Parameters: (5)
  • (string) $join The JOIN clause in the SQL.
    Required: Yes
  • (bool) $in_same_term Whether post should be in the same taxonomy term.
    Required: Yes
  • (int[]|string) $excluded_terms Array of excluded term IDs. Empty string if none were provided.
    Required: Yes
  • (string) $taxonomy Taxonomy. Used to identify the term used when `$in_same_term` is true.
    Required: Yes
  • (WP_Post) $post WP_Post object.
    Required: Yes
Defined at:

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

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


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