钩子文档

get_lastpostmodified

💡 云策文档标注

概述

get_lastpostmodified 是一个 WordPress 过滤器钩子,用于修改站点上最近文章修改时间的返回值。它允许开发者自定义时间格式、时区和文章类型。

关键要点

  • 过滤器名称:get_lastpostmodified
  • 参数:$lastpostmodified(最近修改时间,格式为 'Y-m-d H:i:s' 或 false)、$timezone(时区,接受 'server'、'blog'、'gmt')、$post_type(文章类型)
  • 时区选项:'server' 使用服务器时区,'blog' 使用站点时区,'gmt' 使用 GMT 时区
  • 版本更新:WordPress 5.5.0 添加了 $post_type 参数

代码示例

return apply_filters( 'get_lastpostmodified', $lastpostmodified, $timezone, $post_type );

📄 原文内容

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

Parameters

$lastpostmodifiedstring|false
The most recent time that a post was modified, in ‘Y-m-d H:i:s’ format. False on failure.
$timezonestring
Location to use for getting the post modified date.
See get_lastpostdate() for accepted $timezone values.

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'.

$post_typestring
The post type to check.

Source

return apply_filters( 'get_lastpostmodified', $lastpostmodified, $timezone, $post_type );

Changelog

Version Description
5.5.0 Added the $post_type parameter.
2.3.0 Introduced.