wppaste
WordPress

apply_filters( "get_{$adjacent}_post_where", string $where, bool $in_same_term, int[]|string $excluded_terms, string $taxonomy, WP_Post $post )

Since
2.5.0, 4.4.0
Filters the WHERE 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: <ul> <li>get_next_post_where</li> <li>get_previous_post_where</li> </ul>

Parameters

$wherestring
The WHERE 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.

Fired at · 1

  • wp-includes/link-template.php:1983get_adjacent_post()

Source

	 * @param string       $where          The `WHERE` clause in the SQL.	 * @param bool         $in_same_term   Whether post should be in the same taxonomy term.	 * @param int[]|string $excluded_terms Array of excluded term IDs. Empty string if none were provided.	 * @param string       $taxonomy       Taxonomy. Used to identify the term used when `$in_same_term` is true.	 * @param WP_Post      $post           WP_Post object.	 */	$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 ); 	/**	 * Filters the ORDER BY 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'.

History

Introduced in 2.5.0. Unchanged from 6.7.7 through 7.1.0.

  1. 6.7.7
  2. 6.8.8
  3. 6.9.7
  4. 7.0.4
  5. 7.1.0

Signature, return type and hooks compared across 5 parsed releases.

4.4.0
Added the $taxonomy and $post parameters.from the docblock
2.5.0
Introduced.from the docblock

About this page

Parsed data
Generated from the wordpress-develop 6.8.8 tag, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.
Corrections
Something wrong on this page? Report it and it gets fixed in the next regeneration.