modules/role_delegation/README.txt

$Id: README.txt,v 1.7 2009/06/29 14:42:21 davidlesieur Exp $

README file for the Role Delegation Drupal module.


Description
***********

This module allows site administrators to grant some roles the authority to
assign selected roles to users, without them needing the 'administer
permissions' permission.

For each role, Role Delegation provides a new 'assign <ROLE> role' permission to
allow the assignment of that role.

The module also adds an 'assign all roles' permission. Enabling this permission
for a role is a convenient way to allow the assignment of any other role without
having to check all the 'assign <ROLE> role' permissions in the Permissions
page.

If an administrator has the 'administer users' permission, a role assignment
widget gets displayed in the account creation or editing form. Otherwise, if he
has at least the 'access user profiles' permission, the module adds its own
'Roles' tab to the user profile so that roles can be assigned.


Installation
************

1. Extract the 'role_delegation' module directory, including all its
   subdirectories, into your Drupal modules directory.

2. Go to the Administer > Site building > Modules page, and enable the module.

3. Go to the Administer > User management > Permissions and scroll down to
   the role_delegation group of permissions. Each role now has a corresponding
   'assign <ROLE> role' permission. Grant this permission to roles that shall have
   the power to assign role ROLE to users.

1	$Id: README.txt,v 1.7 2009/06/29 14:42:21 davidlesieur Exp $
2
3	README file for the Role Delegation Drupal module.
4
5
6	Description
7	***********
8
9	This module allows site administrators to grant some roles the authority to
10	assign selected roles to users, without them needing the 'administer
11	permissions' permission.
12
13	For each role, Role Delegation provides a new 'assign <ROLE> role' permission to
14	allow the assignment of that role.
15
16	The module also adds an 'assign all roles' permission. Enabling this permission
17	for a role is a convenient way to allow the assignment of any other role without
18	having to check all the 'assign <ROLE> role' permissions in the Permissions
19	page.
20
21	If an administrator has the 'administer users' permission, a role assignment
22	widget gets displayed in the account creation or editing form. Otherwise, if he
23	has at least the 'access user profiles' permission, the module adds its own
24	'Roles' tab to the user profile so that roles can be assigned.
25
26
27	Installation
28	************
29
30	1. Extract the 'role_delegation' module directory, including all its
31	subdirectories, into your Drupal modules directory.
32
33	2. Go to the Administer > Site building > Modules page, and enable the module.
34
35	3. Go to the Administer > User management > Permissions and scroll down to
36	the role_delegation group of permissions. Each role now has a corresponding
37	'assign <ROLE> role' permission. Grant this permission to roles that shall have
38	the power to assign role ROLE to users.
39