wp_get_post_revisions( int|WP_Post $post, array|null $args = null ): WP_Post[]|int[]
Returns all revisions of specified post.
Contents
Description
See also
Parameters
Return
WP_Post[]|int[] Array of revision objects or IDs, or an empty array if none.
More Information
See the parameters section of the WP_Query documentation for a list of parameters that the parameter $args
accepts.
Source
File: wp-includes/revision.php
.
View all references
function wp_get_post_revisions( $post = 0, $args = null ) {
$post = get_post( $post );
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',
)
);
$revisions = get_children( $args );
if ( ! $revisions ) {
return array();
}
return $revisions;
}
Changelog
Version | Description |
---|---|
2.6.0 | Introduced. |