函数文档

_update_blog_date_on_post_delete()

💡 云策文档标注

概述

_update_blog_date_on_post_delete() 是一个 WordPress 函数,用于在删除已发布文章时更新当前站点的最后更新日期。它通过检查文章类型和状态来确保只处理公开的已发布文章。

关键要点

  • 函数在删除已发布文章时触发,更新站点的 last_updated 字段。
  • 仅处理公开文章类型(public 属性为 true)且状态为 'publish' 的文章。
  • 内部调用 wpmu_update_blogs_date() 来执行日期更新操作。
  • 自 WordPress 3.4.0 版本引入。

代码示例

function _update_blog_date_on_post_delete( $post_id ) {
	$post = get_post( $post_id );

	$post_type_obj = get_post_type_object( $post->post_type );
	if ( ! $post_type_obj || ! $post_type_obj->public ) {
		return;
	}

	if ( 'publish' !== $post->post_status ) {
		return;
	}

	wpmu_update_blogs_date();
}

注意事项

  • 函数参数 $post_id 为必需,表示要删除的文章 ID。
  • 如果文章类型非公开或状态非 'publish',函数会提前返回,不执行更新。
  • 适用于多站点环境,通过 wpmu_update_blogs_date() 更新当前站点日期。

📄 原文内容

Handler for updating the current site’s last updated date when a published post is deleted.

Parameters

$post_idintrequired
Post ID

Source

function _update_blog_date_on_post_delete( $post_id ) {
	$post = get_post( $post_id );

	$post_type_obj = get_post_type_object( $post->post_type );
	if ( ! $post_type_obj || ! $post_type_obj->public ) {
		return;
	}

	if ( 'publish' !== $post->post_status ) {
		return;
	}

	wpmu_update_blogs_date();
}

Changelog

Version Description
3.4.0 Introduced.