WordPress.org
Get WordPress
WordPress.org

WordPress Developer Resources

get_{$adjacent}_post_sort

apply_filters( “get_{$adjacent}_post_sort”, string $order_by, WP_Post $post, string $order )

In this article

Back to top

Filters the ORDER BY 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:

  • get_next_post_sort
  • get_previous_post_sort

Parameters

$order_bystring
The ORDER BY clause in the SQL.
$postWP_Post
WP_Post object.
$orderstring
Sort order. 'DESC' for previous post, 'ASC' for next.

Source

$sort = apply_filters( "get_{$adjacent}_post_sort", "ORDER BY p.post_date $order LIMIT 1", $post, $order );

View all references View on Trac View on GitHub

Used byDescription
get_adjacent_post()wp-includes/link-template.php

Retrieves the adjacent post.

Changelog

VersionDescription
4.9.0Added the $order parameter.
4.4.0Added the $post parameter.
2.5.0Introduced.

User Contributed Notes

You must log in before being able to contribute a note or feedback.