1## "mailman" mailing list configuration settings -*- python -*- 2## captured on Sat Mar 22 00:21:06 2003 3 4## Mailman - The GNU Mailing List Management System 5## Copyright (C) 2003 Free Software Foundation, Inc. 6## 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA 7 8## General options 9# 10# Fundamental list characteristics, including descriptive info and basic 11# behaviors. 12 13# The capitalization of this name can be changed to make it presentable 14# in polite company as a proper noun, or to make an acronym part all 15# upper case, etc. However, the name will be advertised as the email 16# address (e.g., in subscribe confirmation notices), so it should not be 17# otherwise altered. (Email addresses are not case sensitive, but they 18# are sensitive to almost everything else :-) 19real_name = 'Mailman' 20 21# This description is used when the mailing list is listed with other 22# mailing lists, or in headers, and so forth. It should be as succinct 23# as you can get it, while still identifying what the list is. 24description = 'Mailman site list' 25 26# This text will be prepended to subject lines of messages posted to the 27# list, to distinguish mailing list messages in in mailbox summaries. 28# Brevity is premium here, it's ok to shorten long mailing list names to 29# something more concise, as long as it still identifies the mailing 30# list. 31subject_prefix = '[Mailman Site List] ' 32 33# List moderators (and list administrators) are sent daily reminders of 34# requests pending approval, like subscriptions to a moderated list, or 35# postings that are being held for one reason or another. Setting this 36# option causes notices to be sent immediately on the arrival of new 37# requests as well. 38# 39# legal values are: 40# 0 = "No" 41# 1 = "Yes" 42admin_immed_notify = 1 43 44# Should administrator get notices of subscribes and unsubscribes? 45# 46# legal values are: 47# 0 = "No" 48# 1 = "Yes" 49admin_notify_mchanges = 1 50 51# Approval notices are sent when mail triggers certain of the limits 52# except routine list moderation and spam filters, for which notices are 53# not sent. This option overrides ever sending the notice. 54# 55# legal values are: 56# 0 = "No" 57# 1 = "Yes" 58respond_to_post_requests = 1 59 60## Nondigest options 61# 62# Policies concerning immediately delivered list traffic. 63 64# Can subscribers choose to receive mail immediately, rather than in 65# batched digests? 66# 67# legal values are: 68# 0 = "No" 69# 1 = "Yes" 70nondigestable = 1 71 72# Normally, Mailman sends the regular delivery messages to the mail 73# server in batches. This is much more efficent because it reduces the 74# amount of traffic between Mailman and the mail server. 75# 76# However, some lists can benefit from a more personalized approach. In 77# this case, Mailman crafts a new message for each member on the regular 78# delivery list. Turning this feature on may degrade the performance of 79# your site, so you need to carefully consider whether the trade-off is 80# worth it, or whether there are other ways to accomplish what you want. 81# You should also carefully monitor your system load to make sure it is 82# acceptable. 83# 84# Select No to disable personalization and send messages to the members 85# in batches. Select Yes to personalize deliveries and allow additional 86# substitution variables in message headers and footers (see below). In 87# addition, by selecting Full Personalization, the To header of posted 88# messages will be modified to include the member's address instead of 89# the list's posting address. 90# 91# When personalization is enabled, a few more expansion variables that 92# can be included in the <a href="?VARHELP=nondigest/msg_header">message 93# header and message footer. 94# 95# These additional substitution variables will be available for your 96# headers and footers, when this feature is enabled: 97# 98# user_address - The address of the user, coerced to lower case. 99# user_delivered_to - The case-preserved address that the user is 100# subscribed with. user_password - The user's password. user_name - The 101# user's full name. user_optionsurl - The url to the user's option page. 102# 103# 104# 105# legal values are: 106# 0 = "No" 107# 1 = "Yes" 108# 2 = "Full Personalization" 109personalize = 1 110 111# Text appended to the bottom of every immediately-delivery message. 112# This text can include Python format strings which are resolved against 113# list attributes. The list of substitutions allowed are: 114# 115# 116# real_name - The `pretty' name of the list; usually the list name with 117# capitalization. 118# 119# list_name - The name by which the list is identified in URLs, where 120# case is significant. (For backwards compability, _internal_name is 121# equivalent.) 122# 123# host_name - The fully qualified domain name that the list server runs 124# on. 125# 126# web_page_url - The base URL for Mailman. This can be appended with, 127# e.g. listinfo/%(internal_name)s to yield the listinfo page for the 128# mailing list. 129# 130# description - The brief description of the mailing list. 131# 132# info - The full description of the mailing list. 133# 134# cgiext - The extension added to CGI scripts. 135# 136# 137msg_footer = """_______________________________________________ 138%(real_name)s site list 139%(real_name)s@%(host_name)s 140%(web_page_url)slistinfo%(cgiext)s/%(_internal_name)s""" 141 142## Digest options 143# 144# Batched-delivery digest characteristics. 145 146# Can list members choose to receive list traffic bunched in digests? 147# 148# legal values are: 149# 0 = "No" 150# 1 = "Yes" 151digestable = 0 152 153## Privacy options 154# 155# This section allows you to configure subscription and membership 156# exposure policy. You can also control whether this list is public or 157# not. See also the <a 158# href="http://www.wooz.org/mailman/admin/mailman/archive">Archival 159# Options</a> section for separate archive-related privacy settings. 160 161# Advertise this list when people ask what lists are on this machine? 162# 163# legal values are: 164# 0 = "No" 165# 1 = "Yes" 166advertised = 0 167 168# Confirm (*) - email confirmation required Require approval - require 169# list administrator approval for subscriptions Confirm and approve - 170# both confirm and approve 171# 172# (*) when someone requests a subscription, Mailman sends them a notice 173# with a unique subscription request number that they must reply to in 174# order to subscribe. This prevents mischievous (or malicious) people 175# from creating subscriptions for others without their consent. 176# 177# legal values are: 178# 1 = "Confirm" 179# 2 = "Require approval" 180# 3 = "Confirm and approve" 181subscribe_policy = 2 182 183# When members want to leave a list, they will make an unsubscription 184# request, either via the web or via email. Normally it is best for you 185# to allow open unsubscriptions so that users can easily remove 186# themselves from mailing lists (they get really upset if they can't get 187# off lists!). 188# 189# For some lists though, you may want to impose moderator approval 190# before an unsubscription request is processed. Examples of such lists 191# include a corporate mailing list that all employees are required to be 192# members of. 193# 194# legal values are: 195# 0 = "No" 196# 1 = "Yes" 197unsubscribe_policy = 0 198 199# Addresses in this list are banned outright from subscribing to this 200# mailing list, with no further moderation required. Add addresses one 201# per line; start the line with a ^ character to designate a regular 202# expression match. 203ban_list = [] 204 205# When set, the list of subscribers is protected by member or admin 206# password authentication. 207# 208# legal values are: 209# 0 = "Anyone" 210# 1 = "List members" 211# 2 = "List admin only" 212private_roster = 2 213 214# Setting this option causes member email addresses to be transformed 215# when they are presented on list web pages (both in text and as links), 216# so they're not trivially recognizable as email addresses. The 217# intention is to prevent the addresses from being snarfed up by 218# automated web scanners for use by spammers. 219# 220# legal values are: 221# 0 = "No" 222# 1 = "Yes" 223obscure_addresses = 1 224 225## Privacy options 226# 227# When a message is posted to the list, a series of moderation steps are 228# take to decide whether the a moderator must first approve the message 229# or not. This section contains the controls for moderation of both 230# member and non-member postings. 231# 232# <p>Member postings are held for moderation if their <b>moderation 233# flag</b> is turned on. You can control whether member postings are 234# moderated by default or not. 235# 236# <p>Non-member postings can be automatically <a 237# href="?VARHELP=privacy/sender/accept_these_nonmembers" >accepted</a>, 238# <a href="?VARHELP=privacy/sender/hold_these_nonmembers">held for 239# moderation</a>, <a 240# href="?VARHELP=privacy/sender/reject_these_nonmembers" >rejected</a> 241# (bounced), or <a 242# href="?VARHELP=privacy/sender/discard_these_nonmembers" 243# >discarded</a>, either individually or as a group. Any posting from a 244# non-member who is not explicitly accepted, rejected, or discarded, 245# will have their posting filtered by the <a 246# href="?VARHELP=privacy/sender/generic_nonmember_action">general 247# non-member rules</a>. 248# 249# <p>In the text boxes below, add one address per line; start the line 250# with a ^ character to designate a <a href= 251# "https://docs.python.org/2/library/re.html" >Python regular 252# expression</a>. When entering backslashes, do so as if you were using 253# Python raw strings (i.e. you generally just use a single backslash). 254# 255# <p>Note that non-regexp matches are always done first. 256 257# Each list member has a moderation flag which says whether messages 258# from the list member can be posted directly to the list, or must first 259# be approved by the list moderator. When the moderation flag is turned 260# on, list member postings must be approved first. You, the list 261# administrator can decide whether a specific individual's postings will 262# be moderated or not. 263# 264# When a new member is subscribed, their initial moderation flag takes 265# its value from this option. Turn this option off to accept member 266# postings by default. Turn this option on to, by default, moderate 267# member postings first. You can always manually set an individual 268# member's moderation bit by using the membership management screens. 269# 270# legal values are: 271# 0 = "No" 272# 1 = "Yes" 273default_member_moderation = 0 274 275# Hold -- this holds the message for approval by the list moderators. 276# 277# Reject -- this automatically rejects the message by sending a bounce 278# notice to the post's author. The text of the bounce notice can be <a 279# href="?VARHELP=privacy/sender/member_moderation_notice" >configured by 280# you. 281# 282# Discard -- this simply discards the message, with no notice sent to 283# the post's author. 284# 285# 286# legal values are: 287# 0 = "Hold" 288# 1 = "Reject" 289# 2 = "Discard" 290member_moderation_action = 1 291 292# When a post from a non-member is received, the message's sender is 293# matched against the list of explicitly <a 294# href="?VARHELP=privacy/sender/accept_these_nonmembers" >accepted, 295# held, <a href="?VARHELP=privacy/sender/reject_these_nonmembers" 296# >rejected (bounced), and <a 297# href="?VARHELP=privacy/sender/discard_these_nonmembers" >discarded 298# addresses. If no match is found, then this action is taken. 299# 300# legal values are: 301# 0 = "Accept" 302# 1 = "Hold" 303# 2 = "Reject" 304# 3 = "Discard" 305generic_nonmember_action = 2 306 307# Should messages from non-members, which are automatically discarded, 308# be forwarded to the list moderator? 309# 310# legal values are: 311# 0 = "No" 312# 1 = "Yes" 313forward_auto_discards = 1 314 315## Bounce options 316# 317# These policies control the automatic bounce processing system in 318# Mailman. Here's an overview of how it works. 319# 320# <p>When a bounce is received, Mailman tries to extract two pieces of 321# information from the message: the address of the member the message 322# was intended for, and the severity of the problem causing the bounce. 323# The severity can be either <em>hard</em> or <em>soft</em> meaning 324# either a fatal error occurred, or a transient error occurred. When in 325# doubt, a hard severity is used. 326# 327# <p>If no member address can be extracted from the bounce, then the 328# bounce is usually discarded. Otherwise, each member is assigned a 329# <em>bounce score</em> and every time we encounter a bounce from this 330# member we increment the score. Hard bounces increment by 1 while soft 331# bounces increment by 0.5. We only increment the bounce score once per 332# day, so even if we receive ten hard bounces from a member per day, 333# their score will increase by only 1 for that day. 334# 335# <p>When a member's bounce score is greater than the <a 336# href="?VARHELP=bounce/bounce_score_threshold">bounce score 337# threshold</a>, the subscription is disabled. Once disabled, the 338# member will not receive any postings from the list until their 339# membership is explicitly re-enabled (either by the list administrator 340# or the user). However, they will receive occasional reminders that 341# their membership has been disabled, and these reminders will include 342# information about how to re-enable their membership. 343# 344# <p>You can control both the <a 345# href="?VARHELP=bounce/bounce_you_are_disabled_warnings">number of 346# reminders</a> the member will receive and the <a 347# href="?VARHELP=bounce/bounce_you_are_disabled_warnings_interval" 348# >frequency</a> with which these reminders are sent. 349# 350# <p>There is one other important configuration variable; after a 351# certain period of time -- during which no bounces from the member are 352# received -- the bounce information is <a 353# href="?VARHELP=bounce/bounce_info_stale_after">considered stale</a> 354# and discarded. Thus by adjusting this value, and the score threshold, 355# you can control how quickly bouncing members are disabled. You should 356# tune both of these to the frequency and traffic volume of your list. 357 358# By setting this value to No, you disable all automatic bounce 359# processing for this list, however bounce messages will still be 360# discarded so that the list administrator isn't inundated with them. 361# 362# legal values are: 363# 0 = "No" 364# 1 = "Yes" 365bounce_processing = 1 366 367## Archive options 368# 369# List traffic archival policies. 370 371# Is archive file source for public or private archival? 372# 373# legal values are: 374# 0 = "public" 375# 1 = "private" 376archive_private = 1 377