wp_post_revision_title_expanded( int|WP_Post $revision, bool $link = true ): string|false

In this article

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

Parameters

$revisionint|WP_Postrequired
Revision ID or revision object.
$linkbooloptional
Whether to link to revision’s page.

Default:true

Return

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

Source

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 ); } 

Hooks

apply_filters( ‘wp_post_revision_title_expanded’, string $revision_date_author, WP_Post $revision, bool $link )

Filters the formatted author and date for a revision.

Changelog

VersionDescription
3.6.0Introduced.

User Contributed Notes

You must log in before being able to contribute a note or feedback.