Question

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

Retrieve formatted date timestamp of a revision (linked to that revisions’s page).

---

description

---

参数

$revision

(int|object) (Required) Revision ID or revision object.

$link

(bool) (Optional) Link to revisions's page?

Default value: true

---

返回值

(string|false) gravatar, user, i18n formatted datetimestamp or localized 'Current Revision'.

---

源代码

File: wp-includes/post-template.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 );
}

---

更新日志

Version	description
3.6.0	Introduced.

---

相关函数

Uses

• wp-includes/post-template.php: wp_post_revision_title_expanded
• wp-includes/capabilities.php: current_user_can()
• wp-includes/l10n.php: _x()
• wp-includes/l10n.php: __()
• wp-includes/formatting.php: human_time_diff()
• wp-includes/pluggable.php: get_avatar()
• wp-includes/functions.php: date_i18n()
• wp-includes/functions.php: current_time()
• wp-includes/link-template.php: get_edit_post_link()
• wp-includes/plugin.php: apply_filters()
• wp-includes/post.php: get_post()
• wp-includes/revision.php: wp_is_post_autosave()
• wp-includes/revision.php: wp_is_post_revision()
• wp-includes/author-template.php: get_the_author_meta()
Show 9 more uses Hide more uses

---

Used By

• wp-includes/post-template.php: wp_list_post_revisions()

---

User Contributed Notes