W3cubDocs

/WordPress

WP_REST_Revisions_Controller::get_item( WP_REST_Request $request ): WP_REST_Response|WP_Error

Retrieves one revision from the collection.

Parameters

$requestWP_REST_Requestrequired
Full details about the request.

Return

WP_REST_Response|WP_Error Response object on success, or WP_Error object on failure.

Source

public function get_item( $request ) {
	$parent = $this->get_parent( $request['parent'] );
	if ( is_wp_error( $parent ) ) {
		return $parent;
	}

	$revision = $this->get_revision( $request['id'] );
	if ( is_wp_error( $revision ) ) {
		return $revision;
	}

	if ( (int) $parent->ID !== (int) $revision->post_parent ) {
		return new WP_Error(
			'rest_revision_parent_id_mismatch',
			/* translators: %d: A post id. */
			sprintf( __( 'The revision does not belong to the specified parent with id of "%d"' ), $parent->ID ),
			array( 'status' => 404 )
		);
	}

	$response = $this->prepare_item_for_response( $revision, $request );
	return rest_ensure_response( $response );
}

Changelog

Version Description
6.5.0 Added a condition to check that parent id matches revision parent id.
4.7.0 Introduced.

© 2003–2024 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/classes/wp_rest_revisions_controller/get_item