diff options
Diffstat (limited to '')
-rw-r--r-- | admin/www/mailman-admin/node22.html | 293 |
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--> |