modules/userplus/README.txt

*******************************************************
    README.txt for userplus.module for Drupal
*******************************************************

This module was developed by Marc Poris (marcp) and Bill Fitzgerald (bonobo)
of Funny Monkey to make the user administration process more efficient for
administrators.

The userplus module supplements Drupal's user administration with the
following features:

   1. "add multiple users" on a single form
   2. "assign user roles" to multiple users on a single form
   3. "delete multiple users" on a single form
   4. "role switching" makes it easy to move multiple users to a different role

These features can be found alongside Drupal's user administration on the
"user +" tab at admin/user/userplus.

INSTALLATION:

Put the module in your modules directory.
Enable it via admin/modules.
[optional] Copy the contents of userplus.css and paste it into your theme's
style.css.

CONFIGURATION:

It is not necessary to do any configuration, however you may customize the
number of rows that will appear on each of the userplus administration screens
by visiting admin/settings/userplus.

TECHNICAL NOTES:

During "add multiple users" user validation bypasses user.module because
errors that occur are reported through form_set_error().  Since our form
contains different fields than the standard "add user" form, it doesn't make
sense to raise errors on the standard fields.  Also, and this is the main
reason, if multiple errors occur in either 'name' or 'mail' when using the
standard user validation process, we will lose errors past the first one
because they get ignored in form_set_error().  To get around this, we do
our own validation in _userplus_validate_user(), however, since we don't
call hook_user('validate', ...) there is a good chance that this module
will not play nicely with modules that implement and depend on
hook_user('validate', ...).

TO DO:

1. Think about how to possibly separate out core functionality from UI
in user.module so we can reuse more code there.

2. Provide a confirmation form for "delete multiple users" as a safety net.

1	*******************************************************
2	README.txt for userplus.module for Drupal
3	*******************************************************
4
5	This module was developed by Marc Poris (marcp) and Bill Fitzgerald (bonobo)
6	of Funny Monkey to make the user administration process more efficient for
7	administrators.
8
9	The userplus module supplements Drupal's user administration with the
10	following features:
11
12	1. "add multiple users" on a single form
13	2. "assign user roles" to multiple users on a single form
14	3. "delete multiple users" on a single form
15	4. "role switching" makes it easy to move multiple users to a different role
16
17	These features can be found alongside Drupal's user administration on the
18	"user +" tab at admin/user/userplus.
19
20	INSTALLATION:
21
22	Put the module in your modules directory.
23	Enable it via admin/modules.
24	[optional] Copy the contents of userplus.css and paste it into your theme's
25	style.css.
26
27	CONFIGURATION:
28
29	It is not necessary to do any configuration, however you may customize the
30	number of rows that will appear on each of the userplus administration screens
31	by visiting admin/settings/userplus.
32
33	TECHNICAL NOTES:
34
35	During "add multiple users" user validation bypasses user.module because
36	errors that occur are reported through form_set_error(). Since our form
37	contains different fields than the standard "add user" form, it doesn't make
38	sense to raise errors on the standard fields. Also, and this is the main
39	reason, if multiple errors occur in either 'name' or 'mail' when using the
40	standard user validation process, we will lose errors past the first one
41	because they get ignored in form_set_error(). To get around this, we do
42	our own validation in _userplus_validate_user(), however, since we don't
43	call hook_user('validate', ...) there is a good chance that this module
44	will not play nicely with modules that implement and depend on
45	hook_user('validate', ...).
46
47	TO DO:
48
49	1. Think about how to possibly separate out core functionality from UI
50	in user.module so we can reuse more code there.
51
52	2. Provide a confirmation form for "delete multiple users" as a safety net.
53