prosody-modules
4d73a1a6ba68
mod_blocking/README.markdown

Find changesets by keywords by author, files, the commit message, revision number or hash, or revset expression.

Software / code / prosody-modules

Comparison

mod_blocking/README.markdown @ 1803:4d73a1a6ba68

Convert all wiki pages to Markdown
author Kim Alvefur <zash@zash.se>
date Fri, 28 Aug 2015 18:03:58 +0200
parent 1782:mod_blocking/README.wiki@29f3d6b7ad16
child 2232: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 ------ ---------------------------------------------