钩子文档

delete_blog

💡 云策文档标注

概述

delete_blog 是一个 WordPress 动作钩子,在站点被删除之前触发。它已从 5.1.0 版本开始被弃用,建议使用替代方法。

关键要点

  • delete_blog 钩子在站点删除前执行,允许开发者执行自定义操作。
  • 该钩子接受两个参数:$site_id(站点 ID)和 $drop(布尔值,指示是否删除站点表,默认为 false)。
  • 从 WordPress 5.1.0 版本起,delete_blog 已被弃用,推荐使用其他函数如 wp_delete_site() 或 wpmu_delete_blog() 进行站点删除操作。
  • 相关函数包括 wp_delete_site() 和 wpmu_delete_blog(),分别用于从数据库删除站点。

代码示例

do_action_deprecated( 'delete_blog', array( $old_site->id, true ), '5.1.0' );

注意事项

  • 由于 delete_blog 已被弃用,新开发中应避免使用,转而使用推荐的替代函数以确保兼容性和最佳实践。
  • 在维护旧代码时,需注意此钩子的弃用状态,并计划迁移到新方法。

📄 原文内容

Fires before a site is deleted.

Parameters

$site_idint
The site ID.
$dropbool
True if site’s table should be dropped. Default false.

Source

do_action_deprecated( 'delete_blog', array( $old_site->id, true ), '5.1.0' );

Changelog

Version Description
5.1.0 Deprecated.
MU (3.0.0) Introduced.