Question

wp_list_post_revisions( int|WP_Post $post_id,  string $type = 'all' )

Display list of a post’s revisions.

---

description

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

---

参数

$post_id

(int|WP_Post) (Optional) Post ID or WP_Post object. Default is global $post.

$type

(string) (Optional) 'all' (default), 'revision' or 'autosave'

Default value: 'all'

---

源代码

File: wp-includes/post-template.php

function wp_list_post_revisions( $post_id = 0, $type = 'all' ) {
	if ( ! $post = get_post( $post_id ) )
		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( __FUNCTION__, '3.6.0' );
	}

	if ( ! $revisions = wp_get_post_revisions( $post->ID ) )
		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>";
}

---

更新日志

Version	description
2.6.0	Introduced.

---

相关函数

Uses

• wp-includes/capabilities.php: current_user_can()
• wp-includes/l10n.php: __()
• wp-includes/functions.php: _deprecated_argument()
• wp-includes/post-template.php: wp_post_revision_title_expanded()
• wp-includes/post.php: get_post()
• wp-includes/revision.php: wp_get_post_revisions()
• wp-includes/revision.php: wp_is_post_autosave()
Show 2 more uses Hide more uses

---

Used By

• wp-admin/includes/meta-boxes.php: post_revisions_meta_box()

---

User Contributed Notes