get_lastpostmodified( string $timezone = 'server', string $post_type = 'any' ): string

Get the most recent time that a post on the site was modified.


Description

The server timezone is the default and is the difference between GMT and server time. The ‘blog’ value is just when the last post was modified.
The ‘gmt’ is when the last post was modified in GMT time.


Top ↑

Parameters

$timezone string Optional
The timezone for the timestamp. See get_lastpostdate() for information on accepted values.
Default 'server'.
More Arguments from get_lastpostdate( ... $timezone ) The timezone for the timestamp. Accepts 'server', 'blog', or 'gmt'.
'server' uses the server's internal timezone.
'blog' uses the post_date field, which proxies to the timezone set for the site.
'gmt' uses the post_date_gmt field.
Default 'server'.

Default: 'server'

$post_type string Optional
The post type to check. Default 'any'.

Default: 'any'


Top ↑

Return

string The timestamp in 'Y-m-d H:i:s' format, or false on failure.


Top ↑

Source

File: wp-includes/post.php. View all references

function get_lastpostmodified( $timezone = 'server', $post_type = 'any' ) {
	/**
	 * Pre-filter the return value of get_lastpostmodified() before the query is run.
	 *
	 * @since 4.4.0
	 *
	 * @param string|false $lastpostmodified The most recent time that a post was modified,
	 *                                       in 'Y-m-d H:i:s' format, or false. Returning anything
	 *                                       other than false will short-circuit the function.
	 * @param string       $timezone         Location to use for getting the post modified date.
	 *                                       See get_lastpostdate() for accepted `$timezone` values.
	 * @param string       $post_type        The post type to check.
	 */
	$lastpostmodified = apply_filters( 'pre_get_lastpostmodified', false, $timezone, $post_type );

	if ( false !== $lastpostmodified ) {
		return $lastpostmodified;
	}

	$lastpostmodified = _get_last_post_time( $timezone, 'modified', $post_type );
	$lastpostdate     = get_lastpostdate( $timezone, $post_type );

	if ( $lastpostdate > $lastpostmodified ) {
		$lastpostmodified = $lastpostdate;
	}

	/**
	 * Filters the most recent time that a post on the site was modified.
	 *
	 * @since 2.3.0
	 * @since 5.5.0 Added the `$post_type` parameter.
	 *
	 * @param string|false $lastpostmodified The most recent time that a post was modified,
	 *                                       in 'Y-m-d H:i:s' format. False on failure.
	 * @param string       $timezone         Location to use for getting the post modified date.
	 *                                       See get_lastpostdate() for accepted `$timezone` values.
	 * @param string       $post_type        The post type to check.
	 */
	return apply_filters( 'get_lastpostmodified', $lastpostmodified, $timezone, $post_type );
}

Top ↑

Hooks



Top ↑

Changelog

Changelog
Version Description
4.4.0 The $post_type argument was added.
1.2.0 Introduced.

Top ↑

User Contributed Notes

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