pre_get_lastpostmodified

💡 云策文档标注

概述

pre_get_lastpostmodified 是一个 WordPress 过滤器钩子，用于在运行 get_lastpostmodified() 查询之前预过滤其返回值。它允许开发者修改或短路函数执行，控制获取最近文章修改时间的逻辑。

钩子名称：pre_get_lastpostmodified
作用：在 get_lastpostmodified() 执行前过滤其返回值，可用于短路函数或调整输出
参数：$lastpostmodified（字符串或 false，表示最近修改时间，格式为 'Y-m-d H:i:s'），$timezone（时区设置，接受 'server'、'blog' 或 'gmt'），$post_type（文章类型）
返回值：返回 false 以外的值将短路 get_lastpostmodified() 函数
引入版本：WordPress 4.4.0

$lastpostmodified = apply_filters( 'pre_get_lastpostmodified', false, $timezone, $post_type );

📄 原文内容

Pre-filter the return value of get_lastpostmodified() before the query is run.

$lastpostmodifiedstring|false: 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.
$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.

$lastpostmodified = apply_filters( 'pre_get_lastpostmodified', false, $timezone, $post_type );

Used by	Description
get_lastpostmodified()`wp-includes/post.php`	Gets the most recent time that a post on the site was modified.

Version	Description
4.4.0	Introduced.