检索修订版的格式化日期时间戳(链接到该修订版的页面)。

原型

wp_post_revision_title_expanded( int|object $revision, bool $link = true )

参数

$revision (int|object) (Required) 修订版ID或修订对象。

$link (bool) (Optional)   链接到修订页面?

返回值

(string|false)  gravatar,用户,i18n格式化datetimestamp或本地化’当前版本’。

源文件

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

<?php
...
function wp_post_revision_title_expanded( $revision, $link = true ) {
	if ( !$revision = get_post( $revision ) )
		return $revision;
	if ( !in_array( $revision->post_type, array( 'post', 'page', 'revision' ) ) )
		return false;
	$author = get_the_author_meta( 'display_name', $revision->post_author );
	/* translators: revision date format, see https://secure.php.net/date */
	$datef = _x( 'F j, Y @ H:i:s', 'revision date format' );
	$gravatar = get_avatar( $revision->post_author, 24 );
	$date = date_i18n( $datef, strtotime( $revision->post_modified ) );
	if ( $link && current_user_can( 'edit_post', $revision->ID ) && $link = get_edit_post_link( $revision->ID ) )
		$date = "<a href='$link'>$date</a>";
	$revision_date_author = sprintf(
		/* translators: post revision title: 1: author avatar, 2: author name, 3: time ago, 4: date */
		__( '%1$s %2$s, %3$s ago (%4$s)' ),
		$gravatar,
		$author,
		human_time_diff( strtotime( $revision->post_modified ), current_time( 'timestamp' ) ),
		$date
	);
	/* translators: %s: revision date with author avatar */
	$autosavef = __( '%s [Autosave]' );
	/* translators: %s: revision date with author avatar */
	$currentf  = __( '%s [Current Revision]' );
	if ( !wp_is_post_revision( $revision ) )
		$revision_date_author = sprintf( $currentf, $revision_date_author );
	elseif ( wp_is_post_autosave( $revision ) )
		$revision_date_author = sprintf( $autosavef, $revision_date_author );
	/**
	 * Filters the formatted author and date for a revision.
	 *
	 * @since 4.4.0
	 *
	 * @param string  $revision_date_author The formatted string.
	 * @param WP_Post $revision             The revision object.
	 * @param bool    $link                 Whether to link to the revisions page, as passed into
	 *                                      wp_post_revision_title_expanded().
	 */
	return apply_filters( 'wp_post_revision_title_expanded', $revision_date_author, $revision, $link );
}
...
?>

其他

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