do_action_ref_array( 'pre_get_posts', WP_Query $this )

Fires after the query variable object is created, but before the actual query is run.

Description

Note: If using conditional tags, use the method versions within the passed instance (e.g. $this->is_main_query() instead of is_main_query()). This is because the functions like is_main_query() test against the global $wp_query instance, not the passed one.

Parameters

$this

(WP_Query) The WP_Query instance (passed by reference).

Source

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

View on GitHub

Related

Used By

Used By
Used By Description
wp-includes/class-wp-query.php: WP_Query::get_posts()

Retrieve the posts based on query variables.

Changelog

Changelog
Version Description
WP-2.0.0 Introduced.