modules/user_mailman_register/README.txt

User Mailman Register
------

This is a module for mailman subscribing which extends the Mailman manager module features.
The main feature is that, instead of sending user commands in mail format as Mailman Manager does, it sends url requests to the mailman web interface where admins manage lists members.
In this way, the subscription managment in drupal can be:

    * Completely invisible to the end-user, because the mail processing step is not needed
    * Immediate, because it's an http request.
    * Correctly syncronized with mailman.
    * More customizable, because the user options in the mailman administration page are,or can be, integrated.

Requirements
------------

1. A mailman server ( http://www.gnu.org/software/mailman/index.html ) with the web interface enbled and accessible from your drupal webserver.

2. Mailman Manager module ( http://drupal.org/project/mailman_manager ) must be installed and enabled.

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

1. Install the mailman manager form fix at http://drupal.org/node/195437. It's optional but it prevents to show an empty mailman manager tab in the profile of users with mailman manager access denied. 

2. Activate this module as usual.

3. Go to admin/settings/mailman_manager and add your mailman lists.

4. Go to admin/settings/user_mailman_register, choose the general module preferences and activate one or more lists added previuosly. 

 * The mailman list web url for administration, usually something like http://www.mysite.com/cgi-bin/mailman/admin/mylist. 
 * The mailman administrator list password.
 * Default mailman setting applied to new and edit subscriptions. 
 * Your site list interface settings. 

5. Go to admin/user/access and set permissions for your users.

6. Go to user profile to manage the User Mailman Register subscriptions.


Access control
------------------

With user permissions you'll be able to choose the subscription method (Mailman Manager email and/or User Mailman Register http) for a user of your site, and in any moment you can switch between the two methods preserving his subscription status.

The general "access user_mailman_register" permission controls who can subscribe and manage his own subscriptions for allowed lists. The "Visible in user registration form" site configuration option don't need this permission to be on.
 
The "can subscribe to" permission controls what lists, and by who, are allowed to be subscribed.

If you want deny the Mailman Manager method and use only the User Mailman Register method you have simply to uncheck the "access mailman manager" permission of Mailman Manager module.

Just a note: Drupal administrator can always access to mailman manager forms in users profile, but not other users without that permission.

Author and Credits
----------

The User Mailman Register module is developed by Samuele Tognini <samuele@netsons.org>
1	User Mailman Register
2	------
3
4	This is a module for mailman subscribing which extends the Mailman manager module features.
5	The main feature is that, instead of sending user commands in mail format as Mailman Manager does, it sends url requests to the mailman web interface where admins manage lists members.
6	In this way, the subscription managment in drupal can be:
7
8	* Completely invisible to the end-user, because the mail processing step is not needed
9	* Immediate, because it's an http request.
10	* Correctly syncronized with mailman.
11	* More customizable, because the user options in the mailman administration page are,or can be, integrated.
12
13	Requirements
14	------------
15
16	1. A mailman server ( http://www.gnu.org/software/mailman/index.html ) with the web interface enbled and accessible from your drupal webserver.
17
18	2. Mailman Manager module ( http://drupal.org/project/mailman_manager ) must be installed and enabled.
19
20	Installation
21	------------
22
23	1. Install the mailman manager form fix at http://drupal.org/node/195437. It's optional but it prevents to show an empty mailman manager tab in the profile of users with mailman manager access denied.
24
25	2. Activate this module as usual.
26
27	3. Go to admin/settings/mailman_manager and add your mailman lists.
28
29	4. Go to admin/settings/user_mailman_register, choose the general module preferences and activate one or more lists added previuosly.
30
31	* The mailman list web url for administration, usually something like http://www.mysite.com/cgi-bin/mailman/admin/mylist.
32	* The mailman administrator list password.
33	* Default mailman setting applied to new and edit subscriptions.
34	* Your site list interface settings.
35
36	5. Go to admin/user/access and set permissions for your users.
37
38	6. Go to user profile to manage the User Mailman Register subscriptions.
39
40
41	Access control
42	------------------
43
44	With user permissions you'll be able to choose the subscription method (Mailman Manager email and/or User Mailman Register http) for a user of your site, and in any moment you can switch between the two methods preserving his subscription status.
45
46	The general "access user_mailman_register" permission controls who can subscribe and manage his own subscriptions for allowed lists. The "Visible in user registration form" site configuration option don't need this permission to be on.
47
48	The "can subscribe to" permission controls what lists, and by who, are allowed to be subscribed.
49
50	If you want deny the Mailman Manager method and use only the User Mailman Register method you have simply to uncheck the "access mailman manager" permission of Mailman Manager module.
51
52	Just a note: Drupal administrator can always access to mailman manager forms in users profile, but not other users without that permission.
53
54	Author and Credits
55	----------
56
57	The User Mailman Register module is developed by Samuele Tognini <samuele@netsons.org>