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

You appear to be a bot. Output may be restricted

Description

Retrieves formatted date timestamp of a revision (linked to that revisions's page).

Usage

$string|false = wp_post_revision_title_expanded( $revision, $link );

Parameters

$revision
( int|object ) required – Revision ID or revision object.
$link
( bool ) optional default: 1 – Optional. Whether to link to revision's page. Default true.

Returns

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

Source

File name: wordpress/wp-includes/post-template.php
Lines:

1 to 54 of 54
function wp_post_revision_title_expanded( $revision, $link = true ) {
  $revision = get_post( $revision );
  if ( ! $revision ) {
    return $revision;
  }

  if ( ! in_array( $revision->post_type, array( 'post', 'page', 'revision' ), true ) ) {
    return false;
  }

  $author = get_the_author_meta( 'display_name', $revision->post_author );
  /* translators: Revision date format, see https://www.php.net/manual/datetime.format.php */
  $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 ) );
  $edit_link = get_edit_post_link( $revision->ID );
  if ( $link && current_user_can( 'edit_post', $revision->ID ) && $edit_link ) {
    $date = "<a href='$edit_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_gmt ) ),
    $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 );
}
 

 View on GitHub View on Trac