Posts: Add `$post` parameter to modified date and time functions.
Unifies the APIs for getting a post's modified date or time with getting a post's date or time. Adds the `$post` parameter to the functions `get_the_modified_date` and `get_the_modified_time`. Adds the `$post` parameter to the filters `get_the_modified_date` and `get_the_modified_time`. Props Soean, lukecavanagh. Fixes #37059. Built from https://develop.svn.wordpress.org/trunk@37738 git-svn-id: http://core.svn.wordpress.org/trunk@37703 1a063a9b-81f0-0310-95a4-ce76da25c4cd
This commit is contained in:
parent
c8d203e1a3
commit
3b5bb5e067
|
@ -2254,26 +2254,37 @@ function the_modified_date( $d = '', $before = '', $after = '', $echo = true ) {
|
|||
* Retrieve the date on which the post was last modified.
|
||||
*
|
||||
* @since 2.1.0
|
||||
* @since 4.6.0 The `$post` parameter was added.
|
||||
*
|
||||
* @param string $d Optional. PHP date format. Defaults to the "date_format" option
|
||||
* @return string
|
||||
* @param string $d Optional. PHP date format defaults to the date_format option if not specified.
|
||||
* @param int|WP_Post $post Optional. Post ID or WP_Post object. Default current post.
|
||||
* @return false|string Date the current post was modified. False on failure.
|
||||
*/
|
||||
function get_the_modified_date($d = '') {
|
||||
if ( '' == $d )
|
||||
$the_time = get_post_modified_time(get_option('date_format'), null, null, true);
|
||||
else
|
||||
$the_time = get_post_modified_time($d, null, null, true);
|
||||
function get_the_modified_date( $d = '', $post = null ) {
|
||||
$post = get_post( $post );
|
||||
|
||||
if ( ! $post ) {
|
||||
return false;
|
||||
}
|
||||
|
||||
if ( empty( $d ) ) {
|
||||
$the_time = get_post_modified_time( get_option( 'date_format' ), false, $post, true );
|
||||
} else {
|
||||
$the_time = get_post_modified_time( $d, false, $post, true );
|
||||
}
|
||||
|
||||
/**
|
||||
* Filters the date a post was last modified.
|
||||
*
|
||||
* @since 2.1.0
|
||||
* @since 4.6.0 The `$post` parameter was added.
|
||||
*
|
||||
* @param string $the_time The formatted date.
|
||||
* @param string $d PHP date format. Defaults to value specified in
|
||||
* 'date_format' option.
|
||||
* @param string $the_time The formatted date.
|
||||
* @param string $d PHP date format. Defaults to value specified in
|
||||
* 'date_format' option.
|
||||
* @param WP_Post $post WP_Post object.
|
||||
*/
|
||||
return apply_filters( 'get_the_modified_date', $the_time, $d );
|
||||
return apply_filters( 'get_the_modified_date', $the_time, $d, $post );
|
||||
}
|
||||
|
||||
/**
|
||||
|
@ -2397,27 +2408,40 @@ function the_modified_time($d = '') {
|
|||
* Retrieve the time at which the post was last modified.
|
||||
*
|
||||
* @since 2.0.0
|
||||
* @since 4.6.0 The `$post` parameter was added.
|
||||
*
|
||||
* @param string $d Optional Either 'G', 'U', or php date format defaults to the value specified in the time_format option.
|
||||
* @return string
|
||||
* @param string $d Optional. Format to use for retrieving the time the post
|
||||
* was modified. Either 'G', 'U', or php date format defaults
|
||||
* to the value specified in the time_format option. Default empty.
|
||||
* @param int|WP_Post $post Optional. Post ID or WP_Post object. Default current post.
|
||||
* @return false|string Formatted date string or Unix timestamp. False on failure.
|
||||
*/
|
||||
function get_the_modified_time($d = '') {
|
||||
if ( '' == $d )
|
||||
$the_time = get_post_modified_time(get_option('time_format'), null, null, true);
|
||||
else
|
||||
$the_time = get_post_modified_time($d, null, null, true);
|
||||
function get_the_modified_time( $d = '', $post = null ) {
|
||||
$post = get_post( $post );
|
||||
|
||||
if ( ! $post ) {
|
||||
return false;
|
||||
}
|
||||
|
||||
if ( empty( $d ) ) {
|
||||
$the_time = get_post_modified_time( get_option( 'time_format' ), false, $post, true );
|
||||
} else {
|
||||
$the_time = get_post_modified_time( $d, false, $post, true );
|
||||
}
|
||||
|
||||
/**
|
||||
* Filters the localized time a post was last modified.
|
||||
*
|
||||
* @since 2.0.0
|
||||
* @since 4.6.0 The `$post` parameter was added.
|
||||
*
|
||||
* @param string $the_time The formatted time.
|
||||
* @param string $d Format to use for retrieving the time the post was
|
||||
* written. Accepts 'G', 'U', or php date format. Defaults
|
||||
* to value specified in 'time_format' option.
|
||||
* @param WP_Post $post WP_Post object.
|
||||
*/
|
||||
return apply_filters( 'get_the_modified_time', $the_time, $d );
|
||||
return apply_filters( 'get_the_modified_time', $the_time, $d, $post );
|
||||
}
|
||||
|
||||
/**
|
||||
|
|
|
@ -4,7 +4,7 @@
|
|||
*
|
||||
* @global string $wp_version
|
||||
*/
|
||||
$wp_version = '4.6-alpha-37737';
|
||||
$wp_version = '4.6-alpha-37738';
|
||||
|
||||
/**
|
||||
* Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.
|
||||
|
|
Loading…
Reference in New Issue