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 |
|---|---|
| 1007 | * will be used to serve the request instead. |
| 1008 | * |
| 1009 | * @since 4.4.0 |
| 1010 | * |
| 1011 | * @param mixed $result Response to replace the requested version with. Can be anything |
| 1012 | * a normal endpoint can return, or null to not hijack the request. |
| 1013 | * @param WP_REST_Server $server Server instance. |
| 1014 | * @param WP_REST_Request $request Request used to generate the response. |
| 1015 | */ |
| 1016 | $result = apply_filters( 'rest_pre_dispatch', null, $this, $request ); |
| 1017 | |
| 1018 | if ( ! empty( $result ) ) { |
| 1019 | |
| 1020 | // Normalize to either WP_Error or WP_REST_Response... |
| 1021 | $result = rest_ensure_response( $result ); |
| 1022 | |
| 1023 | // ...then convert WP_Error across. |
| 1024 | if ( is_wp_error( $result ) ) { |
| 1025 | $result = $this->error_to_response( $result ); |
| Line | Code |
| 1758 | } |
| 1759 | |
| 1760 | foreach ( $requests as $i => $single_request ) { |
| 1761 | $clean_request = clone $single_request; |
| 1762 | $clean_request->set_url_params( array() ); |
| 1763 | $clean_request->set_attributes( array() ); |
| 1764 | $clean_request->set_default_params( array() ); |
| 1765 | |
| 1766 | /** This filter is documented in wp-includes/rest-api/class-wp-rest-server.php */ |
| 1767 | $result = apply_filters( 'rest_pre_dispatch', null, $this, $clean_request ); |
| 1768 | |
| 1769 | if ( empty( $result ) ) { |
| 1770 | $match = $matches[ $i ]; |
| 1771 | $error = null; |
| 1772 | |
| 1773 | if ( is_wp_error( $validation[ $i ] ) ) { |
| 1774 | $error = $validation[ $i ]; |
| 1775 | } |
| 1776 | |