aboutsummaryrefslogtreecommitdiffstats
path: root/admin/www/mailman-admin/node22.html
diff options
context:
space:
mode:
Diffstat (limited to '')
-rw-r--r--admin/www/mailman-admin/node22.html293
1 files changed, 155 insertions, 138 deletions
diff --git a/admin/www/mailman-admin/node22.html b/admin/www/mailman-admin/node22.html
index 00f14733..d708bc18 100644
--- a/admin/www/mailman-admin/node22.html
+++ b/admin/www/mailman-admin/node22.html
@@ -1,195 +1,212 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<head>
-<title>3.7.1 Subscription rules</title>
-<META NAME="description" CONTENT="3.7.1 Subscription rules">
-<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="node23.html">
-<LINK REL="previous" HREF="node21.html">
-<LINK REL="up" HREF="node21.html">
-<LINK REL="next" HREF="node23.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="node23.html" />
+<link rel="prev" href="node21.html" />
+<link rel="parent" href="node20.html" />
+<link rel="next" href="node23.html" />
+<meta name='aesop' content='information' />
+<title>2.7.2 Sender filters</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="node21.html"><img src="../icons/previous.gif"
- border="0" height="32"
- alt="Previous Page" width="32"></A></td>
-<td><A HREF="node21.html"><img src="../icons/up.gif"
- border="0" height="32"
- alt="Up One Level" width="32"></A></td>
-<td><A HREF="node23.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.1 Subscription rules"
+ href="node21.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.3 Recipient Filters"
+ href="node23.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="node21.html">3.7 The Privacy Options</A>
-<b class="navlabel">Up:</b> <a class="sectref" HREF="node21.html">3.7 The Privacy Options</A>
-<b class="navlabel">Next:</b> <a class="sectref" HREF="node23.html">3.7.2 Sender filters</A>
-<br><hr>
+<div class='online-navigation'>
+<b class="navlabel">Previous:</b>
+<a class="sectref" rel="prev" href="node21.html">2.7.1 Subscription rules</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="node23.html">2.7.3 Recipient Filters</A>
+</div>
+<hr /></div>
</DIV>
<!--End of Navigation Panel-->
-<H3><A NAME="SECTION002371000000000000000">
-3.7.1 Subscription rules</A>
+<H3><A NAME="SECTION002272000000000000000">
+2.7.2 Sender filters</A>
</H3>
<P>
-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.
+When a message is posted to the list, a series of moderation criteria are
+applied to determine the disposition of the message. This section
+contains the modeation controls for postings from both members and
+non-members.
<P>
<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 <i>No</i>, 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.
+<DT><STRONG>default_member_moderation</STRONG></DT>
+<DD>Member postings are held for moderation if their <em>moderation
+ flag</em> is turned on. Note that only the list administrators can
+ change the value of a member's moderation flag.
<P>
-</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:
+You can control whether new members get their moderation flag
+ turned on or off by default when they subscribe to the list. By
+ turning this flag off by default, postings by members will be
+ allowed without further intervention (barring other restrictions
+ such as size or implicit recipient lists - see below). By
+ turning the flag on, you can quarantine new member postings to
+ make sure that they meet your criteria for netiquette, topicality,
+ etc. Once you determine that the new member understands the
+ community's posting rules, you can turn off their moderation flag
+ and let their postings go through unstopped.
<P>
+E-newsletter style lists can also be set up by using the
+ moderation flag. By setting the <code>member_moderation_action</code>
+ to <em>Reject</em>, and by turning off the moderation flag for just
+ the few approved senders, your list will operate in essentially a
+ one-way direction. Note that you'd also need to reject or discard
+ postings from non-members.
-<UL>
-<LI>None - No verification is done on the subscribing
- member. This is also called <i>open subscriptions</i> 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>
+</DD>
+<DT><STRONG>member_moderation_action</STRONG></DT>
+<DD>This is the action to take for postings from a member who's
+ moderation flag is set. For typical discussion lists, you'll
+ likely set this to <em>Hold</em> so that the list moderator will get
+ a chance to manually approve, reject, or discard the message. For
+ e-newsletter and announcement lists, you might want to set this to
+ <em>Reject</em> or <em>Discard</em>.
+
+<P>
+Note that when a moderated member posts to your list, and the
+ <code>member_moderation_action</code> is set to <em>Hold</em>, the message
+ will appear on the administrative requests page. When you dispose
+ of the message, you will be given an opportunity to clear the
+ moderation flag at the same time. If you're quarantining new
+ posts, this makes it very convenient to both approve a new
+ member's post and de-moderate them at the same time.
<P>
-</LI>
-<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.
+</DD>
+<DT><STRONG>member_moderation_notice</STRONG></DT>
+<DD>When a member's moderation flag is turned on and
+ <code>member_moderation_action</code> is <em>Reject</em>, this variable
+ contains the text sent in the rejection notice.
+</DD>
+</DL>
<P>
-</LI>
-<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.
+The next batch of variables controls what happens when non-members
+post messages to the list. Each of these accepts one email address
+per line; regular expressions are allowed if the line starts with the
+(caret) character. These address lists are always consulted in the
+order in which they're presented on this page (i.e. accepts first,
+followed by holds, rejections, and discards).
<P>
-</LI>
-<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.
+<DL>
+<DT><STRONG>accept_these_nonmembers</STRONG></DT>
+<DD>Postings from non-members whose addresses match this list are
+ accepted, barring other list restrictions due to size, implicit
+ recipients, etc. You might want to add alternative addresses of
+ approved posters to this list.
<P>
-</LI>
-</UL>
+</DD>
+<DT><STRONG>hold_these_nonmembers</STRONG></DT>
+<DD>Postings from non-members whose addresses match this list are
+ held for moderator approval.
<P>
</DD>
-<DT><STRONG>unsubscribe_policy</STRONG></DT>
-<DD>Specifies whether the list moderator's approval is required for
- unsubscription requests. <i>No</i> is highly recommended, since
- it is exceedingly impolite to not allow people to leave a mailing
- list whenever they want (i.e. opt-out). <i>Yes</i> is useful in
- some specialized contexts; e.g. you may not want to allow
- employees to unsubscribe from the company newsletter.
+<DT><STRONG>reject_these_nonmembers</STRONG></DT>
+<DD>Postings from non-members whose addresses match this list are
+ rejected, i.e. bounced back to the original sender. There
+ currently is no way to add additional text to the rejection
+ message.
<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.
+<DT><STRONG>discard_these_nonmembers</STRONG></DT>
+<DD>Postings from non-members whose addresses match this list are
+ discarded, with no bounce back message. You might want to add the
+ addresses of known spammers to this list.
<P>
</DD>
-<DT><STRONG>private_roster</STRONG></DT>
-<DD>This specifies who is allowed to view the roster of member
- addresses. If you choose <i>Anyone</i>, 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.
+<DT><STRONG>generic_nonmember_action</STRONG></DT>
+<DD>This variable controls what happens to non-member posts when the
+ address of the sender doesn't match any of the above four lists.
+ If you set this to <em>Hold</em>, the posting will appear on the
+ administrative requests page, and you will be given an opportunity
+ to add the non-member to one of the above four lists at the same
+ time you dispose of the held message.
<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.
+<DT><STRONG>forward_auto_discards</STRONG></DT>
+<DD>When messages from non-members are discarded, either because the
+ sender address matched <code>discard_these_nonmembers</code>, or because
+ <code>generic_nonmember_action</code> is <em>Discard</em>, you can choose
+ whether such messages are forwarded to the lsit administrators or
+ not.
</DD>
</DL>
<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="node21.html"><img src="../icons/previous.gif"
- border="0" height="32"
- alt="Previous Page" width="32"></A></td>
-<td><A HREF="node21.html"><img src="../icons/up.gif"
- border="0" height="32"
- alt="Up One Level" width="32"></A></td>
-<td><A HREF="node23.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.1 Subscription rules"
+ href="node21.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.3 Recipient Filters"
+ href="node23.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="node21.html">3.7 The Privacy Options</A>
-<b class="navlabel">Up:</b> <a class="sectref" HREF="node21.html">3.7 The Privacy Options</A>
-<b class="navlabel">Next:</b> <a class="sectref" HREF="node23.html">3.7.2 Sender filters</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="node21.html">2.7.1 Subscription rules</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="node23.html">2.7.3 Recipient Filters</A>
+</div>
+</div>
+<hr />
+<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span>
</DIV>
<!--End of Navigation Panel-->