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
|
=========================
Subscription moderation
=========================
Subscription (and sometimes unsubscription) requests can similarly be
accepted, discarded, rejected, or deferred by the list moderators.
Viewing subscription requests
=============================
A mailing list starts with no pending subscription or unsubscription requests.
>>> ant = create_list('ant@example.com')
>>> ant.admin_immed_notify = False
>>> from mailman.workflows.subscription import ModerationSubscriptionPolicy
>>> ant.subscription_policy = ModerationSubscriptionPolicy
>>> transaction.commit()
>>> dump_json('http://localhost:9001/3.0/lists/ant.example.com/requests')
http_etag: "..."
start: 0
total_size: 0
When Anne tries to subscribe to the Ant list, her subscription is held for
moderator approval. Her email address is pre-verified and her subscription
request is pre-confirmed, but because the mailing list is moderated, a token
is returned to track her subscription request.
>>> dump_json('http://localhost:9001/3.0/members', {
... 'list_id': 'ant.example.com',
... 'subscriber': 'anne@example.com',
... 'display_name': 'Anne Person',
... 'pre_verified': True,
... })
http_etag: ...
token: 0000000000000000000000000000000000000001
token_owner: moderator
The subscription request can be viewed in the REST API.
>>> transaction.commit()
>>> dump_json('http://localhost:9001/3.0/lists/ant.example.com/requests')
entry 0:
display_name: Anne Person
email: anne@example.com
http_etag: "..."
list_id: ant.example.com
token: 0000000000000000000000000000000000000001
token_owner: moderator
type: sub-policy-moderate
when: 2005-08-01T07:49:23
http_etag: "..."
start: 0
total_size: 1
Viewing individual requests
===========================
You can view an individual membership change request by providing the token
(a.k.a. request id). Anne's subscription request looks like this.
>>> dump_json('http://localhost:9001/3.0/lists/ant.example.com/'
... 'requests/0000000000000000000000000000000000000001')
display_name: Anne Person
email: anne@example.com
http_etag: "..."
list_id: ant.example.com
token: 0000000000000000000000000000000000000001
token_owner: moderator
type: sub-policy-moderate
when: 2005-08-01T07:49:23
Disposing of subscription requests
==================================
Moderators can dispose of held subscription requests by POSTing back to the
request's resource. The POST data requires an action of one of the following:
* discard - throw the request away.
* reject - the request is denied and a notification is sent to the email
address requesting the membership change.
* defer - defer any action on this membership change (continue to hold it).
* accept - accept the membership change.
Anne's subscription request is accepted.
>>> dump_json('http://localhost:9001/3.0/lists/ant.example.com/requests'
... '/0000000000000000000000000000000000000001',
... {'action': 'accept'})
content-length: 0
date: ...
server: ...
status: 204
Anne is now a member of the mailing list.
>>> ant.members.get_member('anne@example.com')
<Member: Anne Person <anne@example.com> on ant@example.com
as MemberRole.member>
There are no more membership change requests.
>>> dump_json('http://localhost:9001/3.0/lists/ant.example.com/requests')
http_etag: "..."
start: 0
total_size: 0
|
