Source View: posts_request

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.

  • Action hooks look like this: do_action( "hook_name" )
  • Filter hooks look like this: apply_filters( "hook_name", "what_to_filter" ).

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
2728           if ( !$q['suppress_filters'] ) {
2729                /**
2730                 * Filters the completed SQL query before sending.
2731                 *
2732                 * @since 2.0.0
2733                 *
2734                 * @param string   $request The complete SQL query.
2735                 * @param WP_Query $this    The WP_Query instance (passed by reference).
2736                 */
2737                $this->request = apply_filters_ref_array( 'posts_request', array( $this->request, &$this ) );
2738           }
2739
2740           /**
2741            * Filters the posts array before the query takes place.
2742            *
2743            * Return a non-null value to bypass WordPress's default post queries.
2744            *
2745            * Filtering functions that require pagination information are encouraged to set
2746            * the `found_posts` and `max_num_pages` properties of the WP_Query object,