显示帖子修订的列表。

原型

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

描述

可以输出带编辑链接的UL或带差异接口的TABLE,以及恢复操作链接。

参数

$post_id (int|WP_Post) (Optional)  发布ID或WP_Post对象。默认为全球$ post。

$type (string) (Optional) ‘全部’(默认),‘修订’或’自动保存’

源文件

路径:wp-includes/post-template.php

<?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>";
}
...
?>

其他

英文文档:https://developer.wordpress.org/reference/functions/wp_list_post_revisions/