1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<!--Converted with jLaTeX2HTML 2002 (1.62) JA patch-1.4
patched version by: Kenshi Muto, Debian Project.
LaTeX2HTML 2002 (1.62),
original version by: Nikos Drakos, CBLU, University of Leeds
* revised and updated by: Marcus Hennecke, Ross Moore, Herb Swan
* with significant contributions from:
Jens Lippmann, Marek Rouchal, Martin Wilck and others -->
<HTML>
<HEAD>
<TITLE>14. Creating and editing mailing using the web</TITLE>
<META NAME="description" CONTENT="14. Creating and editing mailing using the web">
<META NAME="keywords" CONTENT="sympa">
<META NAME="resource-type" CONTENT="document">
<META NAME="distribution" CONTENT="global">
<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-1">
<META NAME="Generator" CONTENT="jLaTeX2HTML v2002 JA patch-1.4">
<META HTTP-EQUIV="Content-Style-Type" CONTENT="text/css">
<LINK REL="STYLESHEET" HREF="sympa.css">
<LINK REL="next" HREF="node16.html">
<LINK REL="previous" HREF="node14.html">
<LINK REL="up" HREF="sympa.html">
<LINK REL="next" HREF="node16.html">
</HEAD>
<BODY TEXT="#000000" BGCOLOR="#ffffff">
<!--Navigation Panel-->
<A NAME="tex2html1043"
HREF="node16.html">
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A>
<A NAME="tex2html1037"
HREF="sympa.html">
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A>
<A NAME="tex2html1031"
HREF="node14.html">
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A>
<A NAME="tex2html1039"
HREF="node1.html">
<IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>
<A NAME="tex2html1041"
HREF="node23.html">
<IMG WIDTH="43" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="index" SRC="index.png"></A>
<BR>
<B> Next:</B> <A NAME="tex2html1044"
HREF="node16.html">15. List configuration parameters</A>
<B> Up:</B> <A NAME="tex2html1038"
HREF="sympa.html">Sympa Mailing Lists Management Software version</A>
<B> Previous:</B> <A NAME="tex2html1032"
HREF="node14.html">13. Mailing list definition</A>
  <B> <A NAME="tex2html1040"
HREF="node1.html">Contents</A></B>
  <B> <A NAME="tex2html1042"
HREF="node23.html">Index</A></B>
<BR>
<BR>
<!--End of Navigation Panel-->
<!--Table of Child-Links-->
<A NAME="CHILD_LINKS"><STRONG>Subsections</STRONG></A>
<UL>
<LI><A NAME="tex2html1045"
HREF="node15.html#SECTION001510000000000000000">14.1 List creation</A>
<UL>
<LI><A NAME="tex2html1046"
HREF="node15.html#SECTION001511000000000000000">14.1.1 Who can create lists</A>
<LI><A NAME="tex2html1047"
HREF="node15.html#SECTION001512000000000000000">14.1.2 typical list profile</A>
</UL>
<BR>
<LI><A NAME="tex2html1048"
HREF="node15.html#SECTION001520000000000000000">14.2 List edition</A>
</UL>
<!--End of Table of Child-Links-->
<HR>
<H1><A NAME="SECTION001500000000000000000"></A>
<A NAME="web-ml-creation"></A>
<BR>
14. Creating and editing mailing using the web
</H1>
<P>
The management of mailing lists by list owners will usually be
done via the web interface. This is based on a strict definition
of privileges which pertain respectively to the
listmaster, to the main list owner, and to basic list owners. The goal is to
allow each listmaster to define who can create lists, and which
parameters may be set by owners. Therefore, a complete
installation requires some careful planning, although default
values should be acceptable for most sites.
<P>
Some features are already available, others will be so shortly, as specified
in the documentation.
<P>
<H1><A NAME="SECTION001510000000000000000">
14.1 List creation</A>
</H1>
<P>
Listmasters have all privileges. Currently the listmaster
is defined in <A NAME="7081"></A><TT>sympa.conf</TT> but in the future, it might be possible to
define one listmaster per virtual robot. By default, newly created
lists must be activated by the listmaster. List creation is possible for all intranet users
(i.e. : users with an e-mail address within the same domain as Sympa).
This is controlled by the <A NAME="7084"></A><TT>create_list</TT> authorization scenario.
<P>
List creation request message and list creation notification message are both
templates that you can customize (<A NAME="7087"></A><TT>create_list_request.tpl</TT> and
<A NAME="7090"></A><TT>list_created.tpl</TT>).
<P>
<H2><A NAME="SECTION001511000000000000000">
14.1.1 Who can create lists</A>
</H2>
<P>
This is defined by the <A NAME="7093"></A><TT>create_list</TT> sympa.conf parameter (see <A HREF="node6.html#create-list">5.1.10</A>,
page <A HREF="node6.html#create-list"><IMG ALIGN="BOTTOM" BORDER="1" ALT="[*]" SRC="crossref.png"></A>). This parameter refers to a <B>create_list</B> authorization scenario.
It will determine if the <I>create list</I> button is displayed and if it requires
a listmaster confirmation.
<P>
The authorization scenario can accept any condition concerning the [sender]
(i.e. WWSympa user), and it returns <A NAME="7096"></A><TT>reject</TT>, <A NAME="7099"></A><TT>do_it</TT>
or <A NAME="7102"></A><TT>listmaster</TT> as an action.
<P>
Only in cases where a user is authorized by the create_list authorization scenario
will the "create" button be available in the main menu.
If the scenario returns <A NAME="7105"></A><TT>do_it</TT>, the list will be created and installed.
If the scenario returns "listmaster", the user is allowed to create a list, but
the list is created with the <A NAME="7108"></A><TT>pending</TT> status,
which means that only the list owner may view or use it.
The listmaster will need to open the list of pending lists
using the "pending list" button in the "server admin"
menu in order to install or refuse a pending list.
<P>
<H2><A NAME="SECTION001512000000000000000">
14.1.2 typical list profile</A>
</H2>
<P>
Mailing lists can have many different uses. <I>Sympa</I> offers a
wide choice of parameters to adapt a list's behavior
to different situations. Users might have difficulty selecting all the
correct parameters, so instead the create list form asks
the list creator simply to choose a profile for the list, and to fill in
the owner's e-mail and the list subject together with a short description.
<P>
List profiles can be stored in <A NAME="7112"></A><TT>/home/sympa/etc/create_list_templates</TT> or
<A NAME="7115"></A><TT>/home/sympa/bin/etc/create_list_templates</TT>, which are part of the Sympa
distribution and should not be modified.
<A NAME="7118"></A><TT>/home/sympa/etc/create_list_templates</TT>, which will not be
overwritten by make install, is intended to contain site customizations.
<P>
A list profile is an almost complete list configuration, but with a number of missing fields
(such as owner e-mail)
to be replaced by WWSympa at installation time. It is easy to create new list
templates by modifying existing ones. Contributions to the distribution are welcome.
<P>
You might want to hide or modify profiles (not useful, or dangerous
for your site). If a profile exists both in the local site directory
<A NAME="7121"></A><TT>/home/sympa/etc/create_list_templates</TT> and
<A NAME="7124"></A><TT>/home/sympa/bin/etc/create_list_templates</TT> directory, then the local profile
will be used by WWSympa.
<P>
Another way to control publicly available profiles is to
edit the <A NAME="7127"></A><TT>create_list.conf</TT> file (the default for this file is in
the <A NAME="7130"></A><TT>/home/sympa/bin/etc</TT> directory, and you may create your own customized
version in <A NAME="7133"></A><TT>/home/sympa/etc</TT>).
This file controls which of the available list templates are to be displayed. Example :<PRE>
# Do not allow the public_anonymous profile
public_anonymous hidden
* read
</PRE>
<P>
When a list is created, whatever its status (<A NAME="7136"></A><TT>pending</TT> or
<A NAME="7139"></A><TT>open</TT>), the owner can use WWSympa admin features to modify list
parameters, or to edit the welcome message, and so on.
<P>
WWSympa logs the creation and all modifications to a list as part of the list's
<A NAME="7142"></A><TT>config</TT> file (and old configuration files are saved).
<P>
<H1><A NAME="SECTION001520000000000000000"></A>
<A NAME="list-edition"></A>
<BR>
14.2 List edition
</H1>
<P>
For each parameter, you may specify (via the <A NAME="7145"></A><TT>/home/sympa/etc/edit_list.conf</TT>
configuration file) who has the right to edit the parameter concerned ; the default
<A NAME="7148"></A><TT>/home/sympa/bin/etc/edit_list.conf</TT> is reasonably safe.
<P>
<PRE>
Each line is a set of 3 field
<Parameter> <Population> <Privilege>
<Population> : <listmaster|privileged_owner|owner>
<Privilege> : <write|read|hidden>
parameter named "default" means any other parameter
</PRE>
<P>
There is no hierarchical relation between populations in this
configuration file. You need to explicitely list populations.
<P>
Eg: listmaster will not match rules refering to owner or privileged_owner
<P><PRE>
examples :
# only listmaster can edit user_data_source, priority, ...
user_data_source listmaster write
priority owner,privileged_owner read
priority listmaster write
# only privileged owner can modify editor parameter, send, ...
editor privileged_owner write
send owner read
send privileged_owner,listmaster write
# other parameters can be changed by simple owners
default owner write
</PRE>
<P>
Privileged owners are defined in the list's <A NAME="7151"></A><TT>config</TT> file as follows :
<PRE>
owner
email owners.email@foo.bar
profile privileged
</PRE>
<P>
The following rules are hard coded in WWSympa :
<UL>
<LI>only listmaster can edit the "profile privileged"
owner attribute
<P>
</LI>
<LI>owners can edit their own attributes (except profile and e-mail)
<P>
</LI>
<LI>the requestor creating a new list becomes a privileged owner
<P>
</LI>
<LI>privileged owners can edit any gecos/reception/info attribute
of any owner
<P>
</LI>
<LI>privileged owners can edit owners' e-mail addresses (but not privileged owners' e-mail addresses)
<P>
</LI>
</UL>
<P>
Sympa aims to define two levels of trust for owners (some being entitled
simply to edit secondary parameters such as "custom_subject", others having
the right to manage more important parameters), while leaving control of
crucial parameters (such as the list of privileged owners and user_data_sources)
in the hands of the listmaster.
Consequently, privileged owners can change owners' e-mails,
but they cannot grant the responsibility of list management to others without
referring to the listmaster.
<P>
<HR>
<!--Navigation Panel-->
<A NAME="tex2html1043"
HREF="node16.html">
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A>
<A NAME="tex2html1037"
HREF="sympa.html">
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A>
<A NAME="tex2html1031"
HREF="node14.html">
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A>
<A NAME="tex2html1039"
HREF="node1.html">
<IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>
<A NAME="tex2html1041"
HREF="node23.html">
<IMG WIDTH="43" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="index" SRC="index.png"></A>
<BR>
<B> Next:</B> <A NAME="tex2html1044"
HREF="node16.html">15. List configuration parameters</A>
<B> Up:</B> <A NAME="tex2html1038"
HREF="sympa.html">Sympa Mailing Lists Management Software version</A>
<B> Previous:</B> <A NAME="tex2html1032"
HREF="node14.html">13. Mailing list definition</A>
  <B> <A NAME="tex2html1040"
HREF="node1.html">Contents</A></B>
  <B> <A NAME="tex2html1042"
HREF="node23.html">Index</A></B>
<!--End of Navigation Panel-->
<ADDRESS>
root
2004-09-10
</ADDRESS>
</BODY>
</HTML>
|
