Docs: Synchronize the `$timezone` parameter description between `get_lastpostdate()`, `get_lastpostmodified()`, and `_get_last_post_time()`.

See #17455.
Built from https://develop.svn.wordpress.org/trunk@34240


git-svn-id: http://core.svn.wordpress.org/trunk@34204 1a063a9b-81f0-0310-95a4-ce76da25c4cd
This commit is contained in:
Sergey Biryukov 2015-09-16 15:29:39 +00:00
parent 15b69a0862
commit aee733684b
2 changed files with 12 additions and 11 deletions

View File

@ -5232,8 +5232,11 @@ function get_posts_by_author_sql( $post_type, $full = true, $post_author = null,
* @since 0.71 * @since 0.71
* @since 4.4.0 The `$post_type` argument was added. * @since 4.4.0 The `$post_type` argument was added.
* *
* @param string $timezone Optional. The location to get the time. Accepts 'gmt', 'blog', * @param string $timezone Optional. The timezone for the timestamp. Accepts 'server', 'blog', or 'gmt'.
* or 'server'. Default 'server'. * 'server' uses the server's internal timezone.
* 'blog' uses the `post_modified` field, which proxies to the timezone set for the site.
* 'gmt' uses the `post_modified_gmt` field.
* Default 'server'.
* @param string $post_type Optional. The post type to check. Default 'any'. * @param string $post_type Optional. The post type to check. Default 'any'.
* @return string The date of the last post. * @return string The date of the last post.
*/ */
@ -5243,9 +5246,9 @@ function get_lastpostdate( $timezone = 'server', $post_type = 'any' ) {
* *
* @since 2.3.0 * @since 2.3.0
* *
* @param string $date Date the last post was published. Likely values are 'gmt', * @param string $date Date the last post was published.
* 'blog', or 'server'.
* @param string $timezone Location to use for getting the post published date. * @param string $timezone Location to use for getting the post published date.
* See {@see get_lastpostdate()} for accepted `$timezone` values.
*/ */
return apply_filters( 'get_lastpostdate', _get_last_post_time( $timezone, 'date', $post_type ), $timezone ); return apply_filters( 'get_lastpostdate', _get_last_post_time( $timezone, 'date', $post_type ), $timezone );
} }
@ -5260,10 +5263,8 @@ function get_lastpostdate( $timezone = 'server', $post_type = 'any' ) {
* @since 1.2.0 * @since 1.2.0
* @since 4.4.0 The `$post_type` argument was added. * @since 4.4.0 The `$post_type` argument was added.
* *
* @param string $timezone Optional. The timezone for the timestamp. Uses the server's internal timezone. * @param string $timezone Optional. The timezone for the timestamp. See {@see get_lastpostdate()}
* Accepts 'server', 'blog', 'gmt'. or 'server'. 'server' uses the server's * for information on accepted values.
* internal timezone. 'blog' uses the `post_modified` field, which proxies
* to the timezone set for the site. 'gmt' uses the `post_modified_gmt` field.
* Default 'server'. * Default 'server'.
* @param string $post_type Optional. The post type to check. Default 'any'. * @param string $post_type Optional. The post type to check. Default 'any'.
* @return string The timestamp. * @return string The timestamp.
@ -5283,7 +5284,7 @@ function get_lastpostmodified( $timezone = 'server', $post_type = 'any' ) {
* *
* @param string $lastpostmodified Date the last post was modified. * @param string $lastpostmodified Date the last post was modified.
* @param string $timezone Location to use for getting the post modified date. * @param string $timezone Location to use for getting the post modified date.
* See {@see get_lastpostmodified()} for accepted `$timezone` values. * See {@see get_lastpostdate()} for accepted `$timezone` values.
*/ */
return apply_filters( 'get_lastpostmodified', $lastpostmodified, $timezone ); return apply_filters( 'get_lastpostmodified', $lastpostmodified, $timezone );
} }
@ -5297,7 +5298,7 @@ function get_lastpostmodified( $timezone = 'server', $post_type = 'any' ) {
* *
* @global wpdb $wpdb * @global wpdb $wpdb
* *
* @param string $timezone The timezone for the timestamp. See {@see get_lastpostmodified()} * @param string $timezone The timezone for the timestamp. See {@see get_lastpostdate()}
* for information on accepted values. * for information on accepted values.
* @param string $field Post field to check. Accepts 'date' or 'modified'. * @param string $field Post field to check. Accepts 'date' or 'modified'.
* @param string $post_type Optional. The post type to check. Default 'any'. * @param string $post_type Optional. The post type to check. Default 'any'.

View File

@ -4,7 +4,7 @@
* *
* @global string $wp_version * @global string $wp_version
*/ */
$wp_version = '4.4-alpha-34239'; $wp_version = '4.4-alpha-34240';
/** /**
* Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema. * Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.