wp_list_post_revisions

函数
wp_list_post_revisions ( $post = 0, $type = 'all' )
参数
  • (int|WP_Post) $post Optional. Post ID or WP_Post object. Default is global $post.
    Required:
  • (string) $type 'all' (default), 'revision' or 'autosave'
    Required:
    Default: 'all'
定义位置
相关方法
wp_is_post_revisionwp_get_post_revisionswp_get_post_revisionwp_delete_post_revision_wp_put_post_revision
引入
2.6.0
弃用
-

wp_list_post_revisions: 这个函数使用一组你可以自定义的参数,检索并显示一个特定文章的修订列表。你可以使用这个函数来显示一个特定文章的修订列表,允许用户比较和恢复该文章的先前版本。

显示两个字符串之间的差异的人类可读的HTML表示。

差异可用于获取版本之间的变化。输出是HTML,所以主要用途是显示变化。如果两个字符串是相等的,那么将返回一个空字符串。

function wp_list_post_revisions( $post = 0, $type = 'all' ) {
	$post = get_post( $post );

	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( __FUNCTION__, '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>';
}

常见问题

FAQs
查看更多 >