get_(adjacent)_post_where │ хук-фильтр │ WP 2.5.0

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

Использование

add_filter( 'get_(adjacent)_post_where', 'wp_kama_get_adjacent_post_where_filter', 10, 5 );

/**
 * Function for `get_(adjacent)_post_where` filter-hook.
 * 
 * @param string  $where          The `WHERE` clause in the SQL.
 * @param bool    $in_same_term   Whether post should be in a same taxonomy term.
 * @param array   $excluded_terms Array of excluded term IDs.
 * @param string  $taxonomy       Taxonomy. Used to identify the term used when `$in_same_term` is true.
 * @param WP_Post $post           WP_Post object.
 *
 * @return string
 */
function wp_kama_get_adjacent_post_where_filter( $where, $in_same_term, $excluded_terms, $taxonomy, $post ){

	// filter...
	return $where;
}

$where(строка)

The WHERE clause in the SQL.

$in_same_term(true|false)

Whether post should be in a same taxonomy term.

$excluded_terms(массив)

Array of excluded term IDs.

$taxonomy(строка)

Taxonomy. Used to identify the term used when $in_same_term is true.

$post(WP_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 );

Где используется хук в WordPress