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 |
|---|---|
| 343 | * Allows modification of the response before returning. |
| 344 | * |
| 345 | * @since 4.4.0 |
| 346 | * @since 4.5.0 Applied to embedded responses. |
| 347 | * |
| 348 | * @param WP_HTTP_Response $result Result to send to the client. Usually a WP_REST_Response. |
| 349 | * @param WP_REST_Server $this Server instance. |
| 350 | * @param WP_REST_Request $request Request used to generate the response. |
| 351 | */ |
| 352 | $result = apply_filters( 'rest_post_dispatch', rest_ensure_response( $result ), $this, $request ); |
| 353 | |
| 354 | // Wrap the response in an envelope if asked for. |
| 355 | if ( isset( $_GET['_envelope'] ) ) { |
| 356 | $result = $this->envelope_response( $result, isset( $_GET['_embed'] ) ); |
| 357 | } |
| 358 | |
| 359 | // Send extra data from response objects. |
| 360 | $headers = $result->get_headers(); |
| 361 | $this->send_headers( $headers ); |
| Line | Code |
| 583 | |
| 584 | // Embedded resources get passed context=embed. |
| 585 | if ( empty( $request['context'] ) ) { |
| 586 | $request['context'] = 'embed'; |
| 587 | } |
| 588 | |
| 589 | $response = $this->dispatch( $request ); |
| 590 | |
| 591 | /** This filter is documented in wp-includes/rest-api/class-wp-rest-server.php */ |
| 592 | $response = apply_filters( 'rest_post_dispatch', rest_ensure_response( $response ), $this, $request ); |
| 593 | |
| 594 | $embeds[] = $this->response_to_data( $response, false ); |
| 595 | } |
| 596 | |
| 597 | // Determine if any real links were found. |
| 598 | $has_links = count( array_filter( $embeds ) ); |
| 599 | |
| 600 | if ( $has_links ) { |
| 601 | $embedded[ $rel ] = $embeds; |