钩子文档

remove_user_role

💡 云策文档标注

概述

remove_user_role 是一个 WordPress 动作钩子,在用户角色被移除后立即触发,用于执行相关自定义操作。

关键要点

  • 触发时机:在用户角色被移除后立即执行。
  • 参数:$user_id(整数,用户ID)和 $role(字符串,被移除的角色)。
  • 相关函数:与 WP_User::remove_role() 和 WP_User::set_role() 关联。
  • 版本:从 WordPress 4.3.0 开始引入。

📄 原文内容

Fires immediately after a role as been removed from a user.

Parameters

$user_idint
The user ID.
$rolestring
The removed role.

Source

do_action( 'remove_user_role', $this->ID, $role );

Changelog

Version Description
4.3.0 Introduced.