wp_list_post_revisions() – Display a list of a post’s revisions.

You appear to be a bot. Output may be restricted

Description

Displays a list of a post's revisions.

Can output either a UL with edit links or a TABLE with diff interface, and restore action links.

Usage

wp_list_post_revisions( $post_id, $type );

Parameters

$post_id
( int|WP_Post ) optional – Optional. Post ID or WP_Post object. Default is global $post.
$type
( string ) optional default: all – 'all' (default), 'revision' or 'autosave'

Returns

void

Source

File name: wordpress/wp-includes/post-template.php
Lines:

1 to 37 of 37
function wp_list_post_revisions( $post_id = 0, $type = 'all' ) {
  $post = get_post( $post_id );
  if ( ! $post ) {
    return;
  }

  // $args array with (parent, format, right, left, type) deprecated since 3.6.
  if ( is_array( $type ) ) {
    $type = ! empty( $type['type'] ) ? $type['type'] : $type;
    _deprecated_argument( wp_list_post_revisions, '3.6.0' );
  }

  $revisions = wp_get_post_revisions( $post->ID );
  if ( ! $revisions ) {
    return;
  }

  $rows = '';
  foreach ( $revisions as $revision ) {
    if ( ! current_user_can( 'read_post', $revision->ID ) ) {
      continue;
    }

    $is_autosave = wp_is_post_autosave( $revision );
    if ( ( 'revision' === $type && $is_autosave ) || ( 'autosave' === $type && ! $is_autosave ) ) {
      continue;
    }

    $rows .= "\t<li>" . wp_post_revision_title_expanded( $revision ) . "</li>\n";
  }

  echo "<div class='hide-if-js'><p>" . __( 'JavaScript must be enabled to use this feature.' ) . "</p></div>\n";

  echo "<ul class='post-revisions hide-if-no-js'>\n";
  echo $rows;
  echo '</ul>';
}
 

 View on GitHub View on Trac