wp_post_revision_title_expanded( int|object $revision, bool $link = true )
Retrieves formatted date timestamp of a revision (linked to that revisions’s page).
Parameters
- $revision
-
(Required) Revision ID or revision object.
- $link
-
(Optional) Whether to link to revision's page.
Default value: true
Return
(string|false) gravatar, user, i18n formatted datetimestamp or localized 'Current Revision'.
Source
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 WP-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 );
}
Changelog
Version | Description |
---|---|
3.6.0 | Introduced. |