WP hooks navigation: Home/browse • Actions index • Filters index
To save our bandwidth, we show only a snippet of code around each occurence of the hook. View complete file in SVN (without highlighting).
The best way to understand what a hook does is to look at where it occurs in the source code.
do_action( "hook_name" )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.
This hook occurs 2 times in this file.
| Line | Code |
|---|---|
| 1069 | * will be used to serve the request instead. |
| 1070 | * |
| 1071 | * @since 4.4.0 |
| 1072 | * |
| 1073 | * @param mixed $result Response to replace the requested version with. Can be anything |
| 1074 | * a normal endpoint can return, or null to not hijack the request. |
| 1075 | * @param WP_REST_Server $server Server instance. |
| 1076 | * @param WP_REST_Request $request Request used to generate the response. |
| 1077 | */ |
| 1078 | $result = apply_filters( 'rest_pre_dispatch', null, $this, $request ); |
| 1079 | |
| 1080 | if ( ! empty( $result ) ) { |
| 1081 | |
| 1082 | // Normalize to either WP_Error or WP_REST_Response... |
| 1083 | $result = rest_ensure_response( $result ); |
| 1084 | |
| 1085 | // ...then convert WP_Error across. |
| 1086 | if ( is_wp_error( $result ) ) { |
| 1087 | $result = $this->error_to_response( $result ); |
| Line | Code |
| 1820 | } |
| 1821 | |
| 1822 | foreach ( $requests as $i => $single_request ) { |
| 1823 | $clean_request = clone $single_request; |
| 1824 | $clean_request->set_url_params( array() ); |
| 1825 | $clean_request->set_attributes( array() ); |
| 1826 | $clean_request->set_default_params( array() ); |
| 1827 | |
| 1828 | /** This filter is documented in wp-includes/rest-api/class-wp-rest-server.php */ |
| 1829 | $result = apply_filters( 'rest_pre_dispatch', null, $this, $clean_request ); |
| 1830 | |
| 1831 | if ( empty( $result ) ) { |
| 1832 | $match = $matches[ $i ]; |
| 1833 | $error = null; |
| 1834 | |
| 1835 | if ( is_wp_error( $validation[ $i ] ) ) { |
| 1836 | $error = $validation[ $i ]; |
| 1837 | } |
| 1838 | |