function hook_user_role_insert

Respond to creation of a new user role.

Modules implementing this hook can act on the user role object when saved to the database. It's recommended that you implement this hook if your module adds additional data to user roles object. The module should save its custom additions to the database.

Parameters

$role: A user role object.

Related topics

File

modules/user/user.api.php, line 426

Code

function hook_user_role_insert($role) {
    // Save extra fields provided by the module to user roles.
    db_insert('my_module_table')->fields(array(
        'rid' => $role->rid,
        'role_description' => $role->description,
    ))
        ->execute();
}