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

Changelog
Version Description
WP-2.6.0 Introduced.