modules/domain_user_default/README.txt

$Id: README.txt,v 1.4 2008/07/11 17:41:17 jhedstrom Exp $

/**
 * @file
 * README for the Domain User Default module
 */

Introduction
------------

The Domain User Default module is a sub-module of the Domain [1]
module that provides each users with a way to choose a default
subdomain. Depending on how the module is configured, the user will be
automatically directed to their chosen subdomain when they land on a
different subdomain.

In order to allow non-authenticated users to select a default domain,
the Domain Session Default module should be enabled. This module
stores a default domain via the Session API [2] module, and seamlessly
transitions this into the users table should the visitor login or
register.

For additional functionality, the Domain Geolocalization [3] module which
provides users with a way to search for nearby subdomains (if the
domains are organized geographically).


Sponsors
--------

The Domain User Default module is sponsored by One Economy
(http://one-economy.com) and developed and maintained by OpenSourcery
(http://opensourcery.com).


Installation
------------

  1) Move the module code into your modules directory, and install

  2) Read the README.txt file packaged with the Domain Access module.

  3) Configure behaviors for existing and new domains at admin/build/domain

  4) The module provides several permissions which need to be granted
     to the desired roles. NOTE: If installing Domain Session Default
     (bundled with this module) for unauthenticated users, then
     anonymous users should be granted the permission "set own domain
     default"

  5) The module provides a block for easy switching of default
     domains, as well as a field in the user account section.

  6) If installing the Domain Geolocalization module, the Domain
     Search block can be enabled and configured at
     admin/build/block. This block can be configured to display a
     user's current default domain, and then provide an AHAH pop-up or
     drop down for switching domains.


References
----------

1. http://drupal.org/project/domain
2. http://drupal.org/project/session_api
3. http://drupal.org/project/domain_geolocalization
1	$Id: README.txt,v 1.4 2008/07/11 17:41:17 jhedstrom Exp $
2
3	/**
4	* @file
5	* README for the Domain User Default module
6	*/
7
8	Introduction
9	------------
10
11	The Domain User Default module is a sub-module of the Domain [1]
12	module that provides each users with a way to choose a default
13	subdomain. Depending on how the module is configured, the user will be
14	automatically directed to their chosen subdomain when they land on a
15	different subdomain.
16
17	In order to allow non-authenticated users to select a default domain,
18	the Domain Session Default module should be enabled. This module
19	stores a default domain via the Session API [2] module, and seamlessly
20	transitions this into the users table should the visitor login or
21	register.
22
23	For additional functionality, the Domain Geolocalization [3] module which
24	provides users with a way to search for nearby subdomains (if the
25	domains are organized geographically).
26
27
28	Sponsors
29	--------
30
31	The Domain User Default module is sponsored by One Economy
32	(http://one-economy.com) and developed and maintained by OpenSourcery
33	(http://opensourcery.com).
34
35
36	Installation
37	------------
38
39	1) Move the module code into your modules directory, and install
40
41	2) Read the README.txt file packaged with the Domain Access module.
42
43	3) Configure behaviors for existing and new domains at admin/build/domain
44
45	4) The module provides several permissions which need to be granted
46	to the desired roles. NOTE: If installing Domain Session Default
47	(bundled with this module) for unauthenticated users, then
48	anonymous users should be granted the permission "set own domain
49	default"
50
51	5) The module provides a block for easy switching of default
52	domains, as well as a field in the user account section.
53
54	6) If installing the Domain Geolocalization module, the Domain
55	Search block can be enabled and configured at
56	admin/build/block. This block can be configured to display a
57	user's current default domain, and then provide an AHAH pop-up or
58	drop down for switching domains.
59
60
61	References
62	----------
63
64	1. http://drupal.org/project/domain
65	2. http://drupal.org/project/session_api
66	3. http://drupal.org/project/domain_geolocalization