WP_REST_Revisions_Controller::get_revision( int $id ): WP_Post|WP_Error

Parameters

$idint

Supplied ID.

Return

WP_Post|WP_Error

Revision post object if ID is valid, WP_Error otherwise.

Uses · 3

• __()Retrieves the translation of $text.
• get_post()Retrieves post data given a post ID or post object.
• WP_Error::__construct()Initializes the error.

Used by · 3

• WP_REST_Revisions_Controller::delete_item()Deletes a single revision.
• WP_REST_Revisions_Controller::delete_item_permissions_check()Checks if a given request has access to delete a revision.
• WP_REST_Revisions_Controller::get_item()Retrieves one revision from the collection.

Source

View on Trac ↗View on GitHub ↗

205	protected function get_revision( $id ) {206		$error = new WP_Error(207			'rest_post_invalid_id',208			__( 'Invalid revision ID.' ),209			array( 'status' => 404 )210		);211 212		if ( (int) $id <= 0 ) {213			return $error;214		}215 216		$revision = get_post( (int) $id );217		if ( empty( $revision ) || empty( $revision->ID ) || 'revision' !== $revision->post_type ) {218			return $error;219		}220 221		return $revision;222	}

History

Introduced in 4.7.2. Unchanged from 6.7.7 through 7.1.0.

1. 6.7.7
2. 6.8.8
3. 6.9.7
4. 7.0.4
5. 7.1.0

Signature, return type and hooks compared across 5 parsed releases.

About this page

Parsed data

Generated from the wordpress-develop 6.7.7 tag, from src/wp-includes/rest-api/endpoints/class-wp-rest-revisions-controller.php, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.

Corrections

Something wrong on this page? Report it and it gets fixed in the next regeneration.