pre_get_posts

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

Description

add_action( 'pre_get_posts', (callback) $array ); 

Parameters (1)

0. $array (callback) => array( $this, 'add_posts_to_loop' )

The array.

Usage

To run the hook, copy the example below.

// run the action 
do_action( 'pre_get_posts', $array ); 

The following example is for adding a hook callback.

// define the pre_get_posts callback 
function action_pre_get_posts( $array ) { 
    // make action magic happen here... 
}; 
         
// add the action 
add_action( 'pre_get_posts', 'action_pre_get_posts', 10, 1 ); 

To remove a hook callback, use the example below.

// remove the action 
remove_action( 'pre_get_posts', 'action_pre_get_posts', 10, 1 );