apply_filters_ref_array( 'posts_results', \WP_Post[] $posts, WP_Query $query )
- Since
- 2.3.0
Filters the raw post results array, prior to status checks.
Compatibility
- WordPress
- since 2.3.0
- 6.7.10
- 6.8.11
- 6.9.10
- 7.0.7
- 7.1.3
Present in every tracked release (6.7.10 to 7.1.3).
Parameters
$posts\WP_Post[]- Array of post objects.
$queryWP_Query- The WP_Query instance (passed by reference).
Where this hook fires · 1
wp-includes/class-wp-query.php:3476WP_Query::get_posts()
Source code
* * @since 2.3.0 * * @param WP_Post[] $posts Array of post objects. * @param WP_Query $query The WP_Query instance (passed by reference). */ $this->posts = apply_filters_ref_array( 'posts_results', array( $this->posts, &$this ) ); } // Check post status to determine if post should be displayed. if ( ! empty( $this->posts ) && ( $this->is_single || $this->is_page ) ) { $status = get_post_status( $this->posts[0] );Changelog
Introduced in 2.3.0. Unchanged from 6.7.10 through 7.1.3.
Signature, return type and hooks compared across 5 parsed releases.
About this page
- Parsed data
- Generated from the wordpress-develop 6.9.10 tag, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.
- Corrections
- Something wrong on this page? Report it and it gets fixed in the next regeneration.