WordPress filter hook · part of WordPress core
posts_search_orderby
A WordPress core filter that 4 plugins also fire themselves, running on 8,130+ sites between them.
“Filters the ORDER BY used when ordering search results.”
How to use posts_search_orderby
It's a filter: your callback receives the value and 1 more argument, and must return the (changed) value.
Add this to your theme's functions.php or a small custom plugin:
add_filter( 'posts_search_orderby', function( $search_orderby, $object ) {
// Change $search_orderby here.
return $search_orderby;
}, 10, 2 );Argument names come from ALD's source. Other plugins may pass different values: check the call in the plugin you're targeting below.
This hook is fired by WordPress core too. Official reference on developer.wordpress.org →
4 plugins that fire posts_search_orderby
Sorted by active installs. Each entry shows where the plugin calls the hook and what it passes.
-
ALD8,000+ installs
apply_filters( 'posts_search_orderby', $search_orderby, $this )includes/ali-product-query.php:752 -
ChinaDS100+ installs
apply_filters( 'posts_search_orderby', $search_orderby, $this )inc/taobao-post-query.php:623 -
HANDMADE30+ installs
apply_filters( 'posts_search_orderby', $search_orderby, $this )includes/class/handmade-post-query.php:867 -
Gospel Resource HubFewer than 10 installs
apply_filters( 'posts_search_orderby', $search_orderby, $this )includes/class-grh-query.php:563
Need a customisation built on this hook?
Tell us what you want to change and which plugin it's for. We'll write it, test it and send it back as a small plugin.