posts_orderby WordPress Filter Hook

The posts_orderby hook is a filter hook that allows you to modify the SQL ORDER BY clause for queries that return posts. This can be useful for customizing the order in which posts are displayed on your site.

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).


Top ↑

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.


Top ↑

Source

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

View on Trac



Top ↑

Changelog

Changelog
VersionDescription
1.5.1Introduced.

The content displayed on this page has been created in part by processing WordPress source code files which are made available under the GPLv2 (or a later version) license by theĀ Free Software Foundation. In addition to this, the content includes user-written examples and information. All material is subject to review and curation by the WPPaste.com community.

Show More