get_next_post_where
Filters the WHERE clause in the SQL for an adjacent post query.
Это один из вариантов динамического хука get_(adjacent)_post_where
Использование
add_filter( 'get_next_post_where', 'wp_kama_get_next_post_where_filter', 10, 5 );
/**
* Function for `get_next_post_where` filter-hook.
*
* @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.
*
* @return string
*/
function wp_kama_get_next_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 the same taxonomy term.
- $excluded_terms(int[]|строка)
- Array of excluded term IDs. Empty string if none were provided.
- $taxonomy(строка)
- Taxonomy. Used to identify the term used when $in_same_term is true.
- $post(WP_Post)
- WP_Post object.
Список изменений
| С версии 2.5.0 | Введена. |
| С версии 4.4.0 | Added the $taxonomy and $post parameters. |
Где вызывается хук
get_next_post_where
wp-includes/link-template.php 1983
$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 );