wp_post_revision_title() WordPress Function

The wp_post_revision_title() function retrieves the title of a revision for a given post.

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

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


Parameters

$revision

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

$link

(bool)(Optional) Whether to link to revision's page.

Default value: true


Top ↑

Return

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


Top ↑

Source

File: wp-includes/post-template.php

1826
1827
1828
1829
1830
1831
1832
1833
1834
1835
1836
1837
1838
1839
1840
1841
1842
1843
1844
1845
1846
1847
1848
1849
1850
1851
1852
1853
1854
1855
1856
function wp_post_revision_title( $revision, $link = true ) {
    $revision = get_post( $revision );
    if ( ! $revision ) {
        return $revision;
    }
 
    if ( ! in_array( $revision->post_type, array( 'post', 'page', 'revision' ), true ) ) {
        return false;
    }
 
    /* translators: Revision date format, see https://www.php.net/manual/datetime.format.php */
    $datef = _x( 'F j, Y @ H:i:s', 'revision date format' );
    /* translators: %s: Revision date. */
    $autosavef = __( '%s [Autosave]' );
    /* translators: %s: Revision date. */
    $currentf = __( '%s [Current Revision]' );
 
    $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>";
    }
 
    if ( ! wp_is_post_revision( $revision ) ) {
        $date = sprintf( $currentf, $date );
    } elseif ( wp_is_post_autosave( $revision ) ) {
        $date = sprintf( $autosavef, $date );
    }
 
    return $date;
}


Top ↑

Changelog

Changelog
VersionDescription
2.6.0Introduced.

The content displayed on this page has been created in part by processing WordPress source code files which are made available under the GPLv2 (or a later version) license by the Free Software Foundation. In addition to this, the content includes user-written examples and information. All material is subject to review and curation by the WPPaste.com community.