wp_get_post_revision( int|WP_Post $post, string $output = OBJECT, string $filter = 'raw' ): WP_Post|array|null
Gets a post revision.
Parameters
-
$post
int|WP_Post Required -
Post ID or post object.
-
$output
string Optional -
The required return type. One of OBJECT, ARRAY_A, or ARRAY_N, which correspond to a WP_Post object, an associative array, or a numeric array, respectively.
Default:
OBJECT
-
$filter
string Optional -
Optional sanitization filter. See sanitize_post() . Default
'raw'
.Default:
'raw'
Return
WP_Post|array|null WP_Post (or array) on success, or null on failure.
Source
File: wp-includes/revision.php
.
View all references
function wp_get_post_revision( &$post, $output = OBJECT, $filter = 'raw' ) {
$revision = get_post( $post, OBJECT, $filter );
if ( ! $revision ) {
return $revision;
}
if ( 'revision' !== $revision->post_type ) {
return null;
}
if ( OBJECT === $output ) {
return $revision;
} elseif ( ARRAY_A === $output ) {
$_revision = get_object_vars( $revision );
return $_revision;
} elseif ( ARRAY_N === $output ) {
$_revision = array_values( get_object_vars( $revision ) );
return $_revision;
}
return $revision;
}
Changelog
Version | Description |
---|---|
2.6.0 | Introduced. |