wpseek.com
A WordPress-centric search engine for devs and theme authors



wp_random_content_posts_orderby › WordPress Function

Since7.2.0
Deprecatedn/a
› wp_random_content_posts_orderby ( $orderby, $query )
Parameters: (2)
  • (string) $orderby The ORDER BY clause of the query.
    Required: Yes
  • (WP_Query) $query The WP_Query instance.
    Required: Yes
Returns:
  • (string) The ORDER BY clause of the query.
Defined at:
Codex:

Orders the random content query randomly.

Added to the 'posts_orderby'} filter by {@see WP::handle_random while the random content query runs. Enforcing the order in SQL prevents {@see 'pre_get_posts'} callbacks setting the order of posts on archives from affecting the selection.


Related Functions: wp_random_content_post_limits, wp_get_random_content_post_types, wp_random_content_split_the_query, wp_is_random_content_query, wp_random_content_pre_get_posts

Source 

function wp_random_content_posts_orderby( $orderby, WP_Query $query ): string {
	if ( wp_is_random_content_query( $query ) ) {
		return 'RAND()';
	}

	return (string) $orderby;
}