A WordPress-centric search engine for devs and theme authors

get_{$adjacent}_post_where › WordPress Filter Hooks

apply_filters( "get_{$adjacent}_post_where", $wpdb->prepare( "WHERE p.post_date $op %s AND p.post_type = %s $where", $current_post_date, $post->post_type )
Parameters: (5)
  • (string) $where The `WHERE` clause in the SQL.
    Required: No
    Default: %s {$where}", $current_post_date, $post->post_type)
  • (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 WHERE 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_where
  • get_previous_post_where


$where = apply_filters( "get_{$adjacent}_post_where", $wpdb->prepare( "WHERE p.post_date $op %s AND p.post_type = %s $where", $current_post_date, $post->post_type ), $in_same_term, $excluded_terms, $taxonomy, $post );