函数文档

_update_posts_count_on_delete()

💡 云策文档标注

概述

_update_posts_count_on_delete() 是一个 WordPress 函数,用于在删除文章时更新当前站点的文章计数。它检查文章状态和类型,仅在符合条件时调用 update_posts_count()。

关键要点

  • 函数用途:处理文章删除事件,更新站点文章计数。
  • 参数:$post_id(整数,必需,文章 ID)和 $post(WP_Post 对象,必需,文章对象)。
  • 条件检查:仅当文章状态为 'publish' 且文章类型为 'post' 时才执行更新。
  • 相关函数:调用 update_posts_count() 来实际更新计数。
  • 版本历史:在 WordPress 6.2.0 中添加了 $post 参数,4.0.0 版本引入。

代码示例

function _update_posts_count_on_delete( $post_id, $post ) {
    if ( ! $post || 'publish' !== $post->post_status || 'post' !== $post->post_type ) {
        return;
    }

    update_posts_count();
}

📄 原文内容

Handler for updating the current site’s posts count when a post is deleted.

Parameters

$post_idintrequired
Post ID.
$postWP_Postrequired
Post object.

Source

function _update_posts_count_on_delete( $post_id, $post ) {
	if ( ! $post || 'publish' !== $post->post_status || 'post' !== $post->post_type ) {
		return;
	}

	update_posts_count();
}

Changelog

Version Description
6.2.0 Added the $post parameter.
4.0.0 Introduced.