apply_filters_ref_array( 'posts_orderby', string $orderby, WP_Query $query )

Filters the ORDER BY clause of the query.

Parameters

$orderby

(string) The ORDER BY clause of the query.

$query

(WP_Query) The WP_Query instance (passed by reference).

More Information

This filter is applied before a post-retrieving SQL statement is executed. Use it to make custom modifications to the orderby. WP_Query is versatile but there may be situations where you need to orderby a value that is in a separate database, a custom equation, etc.

Source

File: wp-includes/class-wp-query.php

View on Trac

Used By

Used By Description
wp-includes/class-wp-query.php: WP_Query::get_posts()

Retrieves an array of posts based on query variables.

Changelog

Version Description
1.5.1 Introduced.

© 2003–2021 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/hooks/posts_orderby