wp_get_post_revisions( int|WP_Post $post_id, array|null $args = null )
Returns all revisions of specified post.
Description
See also
Parameters
- $post_id
-
(Optional) Post ID or WP_Post object. Default is global
$post
. - $args
-
(Optional) Arguments for retrieving post revisions.
Default value: null
Return
(array) An array of revisions, or an empty array if none.
Source
File: wp-includes/revision.php
function wp_get_post_revisions( $post_id = 0, $args = null ) {
$post = get_post( $post_id );
if ( ! $post || empty( $post->ID ) )
return array();
$defaults = array( 'order' => 'DESC', 'orderby' => 'date ID', 'check_enabled' => true );
$args = wp_parse_args( $args, $defaults );
if ( $args['check_enabled'] && ! wp_revisions_enabled( $post ) )
return array();
$args = array_merge( $args, array( 'post_parent' => $post->ID, 'post_type' => 'revision', 'post_status' => 'inherit' ) );
if ( ! $revisions = get_children( $args ) )
return array();
return $revisions;
}
Changelog
Version | Description |
---|---|
WP-2.6.0 | Introduced. |