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