钩子文档

deleted_user

💡 云策文档标注

概述

deleted_user 是一个 WordPress 动作钩子,在用户从站点删除后立即触发,用于执行删除后的附加操作,如清理插件自定义表数据。

关键要点

  • 触发时机:用户删除后立即执行,区别于 delete_user 钩子(删除前触发)。
  • 参数:$id(删除用户的ID)、$reassign(可选,重新分配文章和链接的用户ID)、$user(WP_User 对象)。
  • 多站点注意事项:在 Multisite 安装中,用户可能未从数据库删除,取决于调用 wp_delete_user() 或 wpmu_delete_user()。
  • 用途:适用于需要访问已删除用户数据或执行清理任务的场景。

注意事项

如果需要访问用户元数据或用户表字段,应使用 delete_user 钩子,因为 deleted_user 触发时用户可能已被移除。


📄 原文内容

Fires immediately after a user is deleted from the site.

Description

Note that on a Multisite installation the user may not have been deleted from the database depending on whether wp_delete_user() or wpmu_delete_user() was called.

Parameters

$idint
ID of the deleted user.
$reassignint|null
ID of the user to reassign posts and links to.
Default null, for no reassignment.
$userWP_User
WP_User object of the deleted user.

More Information

The deleted_user action/hook can be used to perform additional actions after a user is deleted. For example, you can delete rows from custom tables created by a plugin.

This hook runs after a user is deleted. The hook delete_user (delete vs deleted) runs before a user is deleted. Choose the appropriate hook for your needs. If you need access to user meta or fields from the user table, use delete_user.

Source

do_action( 'deleted_user', $id, $reassign, $user );

Changelog

Version Description
5.5.0 Added the $user parameter.
2.9.0 Introduced.

User Contributed Notes