Menu Adam R Brown

WP hooks navigation: Home/browseActions indexFilters index

Source View: posts_pre_query

To save our bandwidth, we show only a snippet of code around each occurence of the hook. View complete file in SVN (without highlighting).

Understanding Source Code

The best way to understand what a hook does is to look at where it occurs in the source code.

Remember, this hook may occur in more than one file. Moreover, the hook's context may change from version to version.

Source View

Line Code
2948            * passed to the filter by reference. If WP_Query does not perform a database
2949            * query, it will not have enough information to generate these values itself.
2950            *
2951            * @since 4.6.0
2952            *
2953            * @param WP_Post[]|int[]|null $posts Return an array of post data to short-circuit WP's query,
2954            *                                    or null to allow WP to run its normal queries.
2955            * @param WP_Query             $query The WP_Query instance (passed by reference).
2956            */
2957           $this->posts = apply_filters_ref_array( 'posts_pre_query', array( null, &$this ) );
2958
2959           if ( 'ids' === $q['fields'] ) {
2960                if ( null === $this->posts ) {
2961                     $this->posts = $wpdb->get_col( $this->request );
2962                }
2963
2964                /** @var int[] */
2965                $this->posts      = array_map( 'intval', $this->posts );
2966                $this->post_count = count( $this->posts );