get_(adjacent)_post_join filter-hook . WP 2.5.0
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'.
Usage
add_filter( 'get_(adjacent)_post_join', 'filter_function_name_5255', 10, 5 ); function filter_function_name_5255( $join, $in_same_term, $excluded_terms, $taxonomy, $post ){ // filter... return $join; }
- $join(string)
- The JOIN clause in the SQL.
- $in_same_term(true/false)
- 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.
Changelog
Since 2.5.0 | Introduced. |
Since 4.4.0 | Added the $taxonomy and $post parameters. |
Where the hook is called
get_(adjacent)_post_join
wp-includes/link-template.php 1829
$join = apply_filters( "get_{$adjacent}_post_join", $join, $in_same_term, $excluded_terms, $taxonomy, $post );