set_user_role

Fires after the user's role has changed.

Description

do_action( 'set_user_role', (int) $this_id, (string) $role, (array) $old_roles ); 

Parameters (3)

0. $this_id (int)
The this id.
1. $role (string)
The new role.
2. $old_roles (array)
An array of the user's previous roles.

Usage

To run the hook, copy the example below.
  1. // run the action 
  2. do_action( 'set_user_role', $this_id, $role, $old_roles ); 
The following example is for adding a hook callback.
  1. // define the set_user_role callback 
  2. function action_set_user_role( $this_id, $role, $old_roles ) { 
  3. // make action magic happen here... 
  4. }; 
  5.  
  6. // add the action 
  7. add_action( 'set_user_role', 'action_set_user_role', 10, 3 ); 
To remove a hook callback, use the example below.
  1. // remove the action 
  2. remove_action( 'set_user_role', 'action_set_user_role', 10, 3 ); 

Defined (1)

The action is defined in the following location(s).

/wp-includes/class-wp-user.php  
  1. do_action( 'set_user_role', $this->ID, $role, $old_roles );