modules/alt_login/README.txt

$Id: README.txt,v 1.2 2007/02/17 21:04:06 thehunmonkgroup Exp $

****************************************************

Alternate Login Module -- README

written by Chad Phillips: thehunmonkgroup at yahoo dot com
****************************************************

This module provides an interface that allows registered users to use a login
name which is different than their username.

To use, simply enable the module, set permissions for who can create an alt
login, then visit the user edit page. Enter the alternate login name in the
'Alternate Login' textfield, and save.

Note that users can still login with their normal username--this just adds the
option of another login name. Also note that an alternate login name may not
be equivalent to any other current alternate login name, nor any current
username.

INSTALLATION:

1. Put the entire 'alt_login' folder in either:
      a.  Your main 'modules' folder.
      b.  The modules folder of a multisite installation.
      c.  The 'sites/all/modules' folder.

2. Enable the module at Administer -> Modules.

3. At Administer -> Access control, set the 'create alterate login'
   permission for those roles that should be able to create/edit
   an alt login. If a user has and alt login created for them, but
   they do not have create permissions, then the alt login will be
   displayed as a non-editable form item.

4. At Administer -> User Settings, set your preference for displaying the
   alternate login option upon user registration.  Note that permissioned
   users can still add/edit their alternate login at their account edit
   page regardless of this setting.
1	$Id: README.txt,v 1.2 2007/02/17 21:04:06 thehunmonkgroup Exp $
2
3	****************************************************
4
5	Alternate Login Module -- README
6
7	written by Chad Phillips: thehunmonkgroup at yahoo dot com
8	****************************************************
9
10	This module provides an interface that allows registered users to use a login
11	name which is different than their username.
12
13	To use, simply enable the module, set permissions for who can create an alt
14	login, then visit the user edit page. Enter the alternate login name in the
15	'Alternate Login' textfield, and save.
16
17	Note that users can still login with their normal username--this just adds the
18	option of another login name. Also note that an alternate login name may not
19	be equivalent to any other current alternate login name, nor any current
20	username.
21
22	INSTALLATION:
23
24	1. Put the entire 'alt_login' folder in either:
25	a. Your main 'modules' folder.
26	b. The modules folder of a multisite installation.
27	c. The 'sites/all/modules' folder.
28
29	2. Enable the module at Administer -> Modules.
30
31	3. At Administer -> Access control, set the 'create alterate login'
32	permission for those roles that should be able to create/edit
33	an alt login. If a user has and alt login created for them, but
34	they do not have create permissions, then the alt login will be
35	displayed as a non-editable form item.
36
37	4. At Administer -> User Settings, set your preference for displaying the
38	alternate login option upon user registration. Note that permissioned
39	users can still add/edit their alternate login at their account edit
40	page regardless of this setting.