Mercurial > prosody-modules

comparison mod_blocking/README.markdown @ 1803:4d73a1a6ba68

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Convert all wiki pages to Markdown
author Kim Alvefur <zash@zash.se>
date Fri, 28 Aug 2015 18:03:58 +0200
parents mod_blocking/README.wiki@29f3d6b7ad16
children 836b36d8bfd2
comparison
equal deleted inserted replaced
1802:0ab737feada6 1803:4d73a1a6ba68
1 ---
2 labels:
3 - 'Stage-Alpha'
4 summary: 'XEP-0191: Simple Communications Blocking support'
5 ...
6
7 Introduction
8 ============
9
10 Privacy lists are a widely implemented protocol for instructing your
11 server on blocking communications with selected users and services.
12
13 However experience has shown that the power and flexibility of the
14 rule-based system that privacy lists allow is very often much more
15 complex than the user needs, and that in most cases a simple block on
16 all communications to or from a list of specified JIDs would suffice.
17
18 Such a protocol would also allow much simpler user interface design than
19 the current attempts at full privacy list interfaces.
20
21 Details
22 =======
23
24 Simple Communications Blocking was developed to solve the above issues,
25 and allows the client to manage a simple list of blocked JIDs. This
26 plugin implements support for that protocol in Prosody, however the
27 actual blocking is still managed by mod\_privacy, so it is **required**
28 for that plugin to be loaded (this may change in future).
29
30 An XEP-0191 implementation without dependency on mod\_privacy is
31 available in Prosody 0.10 as
32 [mod\_blocklist](https://prosody.im/doc/modules/mod_blocklist).
33
34 Configuration
35 =============
36
37 Simply ensure that mod\_privacy (or mod\_privacy\_lists in 0.10+) and
38 mod\_blocking are loaded in your modules\_enabled list:
39
40 modules_enabled = {
41 -- ...
42 "privacy", -- or privacy_lists in Prosody 0.10+
43 "blocking",
44 -- ...
45
46 Compatibility
47 =============
48
49 ------ ---------------------------------------------
50 0.10 Works but will conflict with mod\_blocklist
51 0.9 Works
52 0.8 Works
53 0.7 Works
54 0.6 Doesn't work
55 ------ ---------------------------------------------