Action hook 'set_user_role'

Hook Information

Hook Parameters

Usage Examples

<?php
// Hook into set_user_role
add_action('set_user_role', 'my_custom_function', 10, 3);

function my_custom_function($user_id, $role, $old_roles) {
    // Your custom code here
}

Source Code Context

<?php
 652  		 *
 653  		 * @param int      $user_id   The user ID.
 654  		 * @param string   $role      The new role.
 655  		 * @param string[] $old_roles An array of the user's previous roles.
 656  		 */
 657  		do_action( 'set_user_role', $this->ID, $role, $old_roles );
 658  	}
 659  
 660  	/**
 661  	 * Chooses the maximum level the user has.
 662  	 *

PHP Documentation

<?php
/**
		 * Fires after the user's role has changed.
		 *
		 * @since 2.9.0
		 * @since 3.6.0 Added $old_roles to include an array of the user's previous roles.
		 *
		 * @param int      $user_id   The user ID.
		 * @param string   $role      The new role.
		 * @param string[] $old_roles An array of the user's previous roles.
		 */