aboutsummaryrefslogtreecommitdiffstats
path: root/admin/www/mailman-admin/node21.html
diff options
context:
space:
mode:
Diffstat (limited to '')
-rw-r--r--admin/www/mailman-admin/node21.html271
1 files changed, 152 insertions, 119 deletions
diff --git a/admin/www/mailman-admin/node21.html b/admin/www/mailman-admin/node21.html
index 55fa06dd..03d23444 100644
--- a/admin/www/mailman-admin/node21.html
+++ b/admin/www/mailman-admin/node21.html
@@ -1,168 +1,201 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<head>
-<title>3.7 The Privacy Options Category</title>
-<META NAME="description" CONTENT="3.7 The Privacy Options Category">
-<META NAME="keywords" CONTENT="mailman-admin">
-<META NAME="resource-type" CONTENT="document">
-<META NAME="distribution" CONTENT="global">
-<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
-<link rel="STYLESHEET" href="mailman-admin.css">
-<link rel="first" href="mailman-admin.html">
-<link rel="contents" href="contents.html" title="Contents">
-
-<LINK REL="next" HREF="node26.html">
-<LINK REL="previous" HREF="node20.html">
-<LINK REL="up" HREF="node9.html">
-<LINK REL="next" HREF="node22.html">
+<link rel="STYLESHEET" href="mailman-admin.css" type='text/css' />
+<link rel="first" href="mailman-admin.html" title='GNU Mailman - List Administration Manual' />
+<link rel='contents' href='contents.html' title="Contents" />
+<link rel='last' href='about.html' title='About this document...' />
+<link rel='help' href='about.html' title='About this document...' />
+<link rel="next" href="node22.html" />
+<link rel="prev" href="node20.html" />
+<link rel="parent" href="node20.html" />
+<link rel="next" href="node22.html" />
+<meta name='aesop' content='information' />
+<title>2.7.1 Subscription rules</title>
</head>
<body>
<DIV CLASS="navigation">
+<div id='top-navigation-panel' xml:id='top-navigation-panel'>
<table align="center" width="100%" cellpadding="0" cellspacing="2">
<tr>
-<td><A HREF="node20.html"><img src="../icons/previous.gif"
- border="0" height="32"
- alt="Previous Page" width="32"></A></td>
-<td><A HREF="node9.html"><img src="../icons/up.gif"
- border="0" height="32"
- alt="Up One Level" width="32"></A></td>
-<td><A HREF="node22.html"><img src="../icons/next.gif"
- border="0" height="32"
- alt="Next Page" width="32"></A></td>
+<td class='online-navigation'><a rel="prev" title="2.7 The Privacy Options"
+ href="node20.html"><img src='previous.png'
+ border='0' height='32' alt='Previous Page' width='32' /></A></td>
+<td class='online-navigation'><a rel="parent" title="2.7 The Privacy Options"
+ href="node20.html"><img src='up.png'
+ border='0' height='32' alt='Up One Level' width='32' /></A></td>
+<td class='online-navigation'><a rel="next" title="2.7.2 Sender filters"
+ href="node22.html"><img src='next.png'
+ border='0' height='32' alt='Next Page' width='32' /></A></td>
<td align="center" width="100%">GNU Mailman - List Administration Manual</td>
-<td><A href="contents.html"><img src="../icons/contents.gif"
- border="0" height="32"
- alt="Contents" width="32"></A></td>
-<td><img src="../icons/blank.gif"
- border="0" height="32"
- alt="" width="32"></td>
-<td><img src="../icons/blank.gif"
- border="0" height="32"
- alt="" width="32"></td>
+<td class='online-navigation'><a rel="contents" title="Table of Contents"
+ href="contents.html"><img src='contents.png'
+ border='0' height='32' alt='Contents' width='32' /></A></td>
+<td class='online-navigation'><img src='blank.png'
+ border='0' height='32' alt='' width='32' /></td>
+<td class='online-navigation'><img src='blank.png'
+ border='0' height='32' alt='' width='32' /></td>
</tr></table>
-<b class="navlabel">Previous:</b> <a class="sectref" HREF="node20.html">3.6 The Digest Options</A>
-<b class="navlabel">Up:</b> <a class="sectref" HREF="node9.html">3 The List Configuration</A>
-<b class="navlabel">Next:</b> <a class="sectref" HREF="node22.html">3.7.1 Subscription rules</A>
-<br><hr>
+<div class='online-navigation'>
+<b class="navlabel">Previous:</b>
+<a class="sectref" rel="prev" href="node20.html">2.7 The Privacy Options</A>
+<b class="navlabel">Up:</b>
+<a class="sectref" rel="parent" href="node20.html">2.7 The Privacy Options</A>
+<b class="navlabel">Next:</b>
+<a class="sectref" rel="next" href="node22.html">2.7.2 Sender filters</A>
+</div>
+<hr /></div>
</DIV>
<!--End of Navigation Panel-->
-<H2><A NAME="SECTION002370000000000000000">
-3.7 The Privacy Options Category</A>
-</H2>
+<H3><A NAME="SECTION002271000000000000000">
+2.7.1 Subscription rules</A>
+</H3>
<P>
-The Privacy category lets you control how much of the list's
-information is public, as well as who can send messages to your list.
-It also contains some spam detection filters. Note that this section
-is not used to control whether your list's archives are public or
-private; for that, use the <A HREF="#Archiving_options"><tex2html_cross_ref_visible_mark></A> category.
+This subcategory controls the rules for exposing the existance of this
+list, and for what new members must do in order to subscribe to the
+list.
<P>
-There are four sub-categories:
-
-<UL>
-<LI>Subscription rules - i.e. the rules for joining and leaving
- your mailing list
-
-<P>
-</LI>
-<LI>Sender filters - the rules for who may post messages to your
- list
+<DL>
+<DT><STRONG>advertised</STRONG></DT>
+<DD>This option controls whether this list will show up in the list
+ overview for the site. Normally, an overview contains the name
+ and short description of every mailing list in the virtual
+ domain. By setting this variable to <em>No</em>, it will not show
+ up in this overview, nor will it show up in the administrative
+ overview. The only way then to find the list is to guess (or
+ know!) its name.
<P>
-</LI>
-<LI>Recipient filters - moderation rules based on the recipient of
- the message
-
-<P>
-</LI>
-<LI>Spam filters - some regular expression based rules for header
- matching
-</LI>
-</UL>
-
-<P>
-The sender, recipient, and spam filtering rules are part of the
-general list moderation features of Mailman. When a message is posted
-to the list, it is matched against a number of criteria, the outcome
-of which determines whether the message is reflected to the membership
-or not. In general, the outcome is one of four states:
+</DD>
+<DT><STRONG>subscribe_policy</STRONG></DT>
+<DD>This option controls the steps that a new member must take to join
+ the list. The available options may differ based on some defaults
+ that the site administrator chooses. They are:
<P>
<UL>
-<LI>Approved or Accepted - the message may be sent on to the
- members of the mailing list.
+<LI>None - No verification is done on the subscribing
+ member. This is also called <em>open subscriptions</em> and is
+ generally disabled by default. The site administrator must
+ allow list admins to choose this option; if not, this option
+ will not be presented to you.
<P>
</LI>
-<LI>Hold - the message will be held for moderator approval. The
- list owners and moderators will then have to explicitly approve
- the message before the list members will see it.
+<LI>Confirm - An email confirmation step is required before the
+ address is added to the list. When a member requests
+ subscription, either via the web page or by sending a
+ message to <var>yourlist</var><code>-join@example.com</code>, Mailman
+ will send a confirmation message to the requesting address.
+ This mail-back confirmation contains a unique identifier,
+ which the requester can present to Mailman in order to
+ confirm their subscription. This can be done either by
+ replying to the mail-back, or by visiting the url in the
+ mail-back message. The url points to a page that lets the
+ user either discard or confirm their request.
<P>
</LI>
-<LI>Reject - the message is bounced back to the original sender,
- often with a notice containing the reason the message was
- rejected. The list members never see rejected messages.
+<LI>Require approval - All subscription requests are held for
+ approval of the list moderator. No mail-back confirmation
+ is sent, but the list admins will recieve a message
+ indicating that approval is pending.
<P>
</LI>
-<LI>Discard - the message is simply thrown away without further
- processing.
+<LI>Confirm and approve - Here, a mail-back notice must first
+ be confirmed by the requester. Once confirmed, the list
+ moderator must then approve the request. This is the most
+ secure method for users to subscribe since it both verifies
+ the requesting address, and forces the list moderators to
+ approve the request.
+
+<P>
</LI>
</UL>
<P>
-Many of the fields in this section are text boxes accepting addresses,
-one per line. Unless otherwise noted, these also accept regular
-expressions which will be matched against an address, if the line
-begins with a (caret) character.
+</DD>
+<DT><STRONG>unsubscribe_policy</STRONG></DT>
+<DD>Specifies whether the list moderator's approval is required for
+ unsubscription requests. <em>No</em> is highly recommended, since
+ it is exceedingly impolite to not allow people to leave a mailing
+ list whenever they want (i.e. opt-out). <em>Yes</em> is useful in
+ some specialized contexts; e.g. you may not want to allow
+ employees to unsubscribe from the company newsletter.
<P>
+</DD>
+<DT><STRONG>ban_list</STRONG></DT>
+<DD>This contains a list of addresses (or regular expressiosn), one
+ per line, that are banned from ever subscribing to your mailing
+ list. If a match occurs during the subscription process, the
+ request will be automatically rejected, and the requester will get
+ a rejection notice. You can use this to permanently ban
+ troublesome posters to a members-only list.
-<p><hr>
-<!--Table of Child-Links-->
-<A NAME="CHILD_LINKS"><STRONG>Subsections</STRONG></a>
+<P>
+</DD>
+<DT><STRONG>private_roster</STRONG></DT>
+<DD>This specifies who is allowed to view the roster of member
+ addresses. If you choose <em>Anyone</em>, then the list membership
+ is completely public. You can limit exposure of the roster to
+ just list members, or just to the list administrators. In the
+ former case, a user must enter a valid member's address and
+ password before they can view the roster. In the latter case, a
+ list administrator's password must be enter; if a matching admin
+ password is entered, address field is ignored.
+
+<P>
+</DD>
+<DT><STRONG>obscure_addresses</STRONG></DT>
+<DD>Controls whether some simple obfuscation of addresses is used when
+ member addresses are included on web pages. This should reduce
+ the opportunity for email address harvesting by spammers, although
+ it probably doesn't eliminate it.
+</DD>
+</DL>
-<UL CLASS="ChildLinks">
-<LI><A href="node22.html">3.7.1 Subscription rules</a>
-<LI><A href="node23.html">3.7.2 Sender filters</a>
-<LI><A href="node24.html">3.7.3 Recipient Filters</a>
-<LI><A href="node25.html">3.7.4 Spam Filters</a>
-</ul>
-<!--End of Table of Child-Links-->
+<P>
<DIV CLASS="navigation">
-<p><hr>
+<div class='online-navigation'>
+<p></p><hr />
<table align="center" width="100%" cellpadding="0" cellspacing="2">
<tr>
-<td><A HREF="node20.html"><img src="../icons/previous.gif"
- border="0" height="32"
- alt="Previous Page" width="32"></A></td>
-<td><A HREF="node9.html"><img src="../icons/up.gif"
- border="0" height="32"
- alt="Up One Level" width="32"></A></td>
-<td><A HREF="node22.html"><img src="../icons/next.gif"
- border="0" height="32"
- alt="Next Page" width="32"></A></td>
+<td class='online-navigation'><a rel="prev" title="2.7 The Privacy Options"
+ href="node20.html"><img src='previous.png'
+ border='0' height='32' alt='Previous Page' width='32' /></A></td>
+<td class='online-navigation'><a rel="parent" title="2.7 The Privacy Options"
+ href="node20.html"><img src='up.png'
+ border='0' height='32' alt='Up One Level' width='32' /></A></td>
+<td class='online-navigation'><a rel="next" title="2.7.2 Sender filters"
+ href="node22.html"><img src='next.png'
+ border='0' height='32' alt='Next Page' width='32' /></A></td>
<td align="center" width="100%">GNU Mailman - List Administration Manual</td>
-<td><A href="contents.html"><img src="../icons/contents.gif"
- border="0" height="32"
- alt="Contents" width="32"></A></td>
-<td><img src="../icons/blank.gif"
- border="0" height="32"
- alt="" width="32"></td>
-<td><img src="../icons/blank.gif"
- border="0" height="32"
- alt="" width="32"></td>
+<td class='online-navigation'><a rel="contents" title="Table of Contents"
+ href="contents.html"><img src='contents.png'
+ border='0' height='32' alt='Contents' width='32' /></A></td>
+<td class='online-navigation'><img src='blank.png'
+ border='0' height='32' alt='' width='32' /></td>
+<td class='online-navigation'><img src='blank.png'
+ border='0' height='32' alt='' width='32' /></td>
</tr></table>
-<b class="navlabel">Previous:</b> <a class="sectref" HREF="node20.html">3.6 The Digest Options</A>
-<b class="navlabel">Up:</b> <a class="sectref" HREF="node9.html">3 The List Configuration</A>
-<b class="navlabel">Next:</b> <a class="sectref" HREF="node22.html">3.7.1 Subscription rules</A>
-<hr>
-<span class="release-info">Release 2.1, documentation updated on October 2, 2004.</span>
+<div class='online-navigation'>
+<b class="navlabel">Previous:</b>
+<a class="sectref" rel="prev" href="node20.html">2.7 The Privacy Options</A>
+<b class="navlabel">Up:</b>
+<a class="sectref" rel="parent" href="node20.html">2.7 The Privacy Options</A>
+<b class="navlabel">Next:</b>
+<a class="sectref" rel="next" href="node22.html">2.7.2 Sender filters</A>
+</div>
+</div>
+<hr />
+<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span>
</DIV>
<!--End of Navigation Panel-->