Menu Adam R Brown

WP hooks navigation: Home/browseActions indexFilters index

Source View: rest_pre_dispatch

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

This hook occurs 2 times in this file.

Line Code
975            * will be used to serve the request instead.
976            *
977            * @since 4.4.0
978            *
979            * @param mixed           $result  Response to replace the requested version with. Can be anything
980            *                                 a normal endpoint can return, or null to not hijack the request.
981            * @param WP_REST_Server  $server  Server instance.
982            * @param WP_REST_Request $request Request used to generate the response.
983            */
984           $result = apply_filters( 'rest_pre_dispatch', null, $this, $request );
985
986           if ( ! empty( $result ) ) {
987
988                // Normalize to either WP_Error or WP_REST_Response...
989                $result = rest_ensure_response( $result );
990
991                // ...then convert WP_Error across.
992                if ( is_wp_error( $result ) ) {
993                     $result = $this->error_to_response( $result );
 
Line Code
1689           }
1690
1691           foreach ( $requests as $i => $single_request ) {
1692                $clean_request = clone $single_request;
1693                $clean_request->set_url_params( array() );
1694                $clean_request->set_attributes( array() );
1695                $clean_request->set_default_params( array() );
1696
1697                /** This filter is documented in wp-includes/rest-api/class-wp-rest-server.php */
1698                $result = apply_filters( 'rest_pre_dispatch', null, $this, $clean_request );
1699
1700                if ( empty( $result ) ) {
1701                     $match = $matches[ $i ];
1702                     $error = null;
1703
1704                     if ( is_wp_error( $validation[ $i ] ) ) {
1705                          $error = $validation[ $i ];
1706                     }
1707