Mercurial > prosody-modules

comparison mod_blocking/README.md @ 5975:fe081789f7b5

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
All community modules: Unify file extention of Markdown files to .md
author Menel <menel@snikket.de>
date Tue, 22 Oct 2024 10:26:01 +0200
parents mod_blocking/README.markdown@7d11a3133d17
children
comparison
equal deleted inserted replaced
5974:5a65a632d5b9 5975:fe081789f7b5
1 ---
2 labels:
3 - Stage-Deprecated
4 rockspec:
5 dependencies:
6 - mod_privacy_lists
7 summary: "XEP-0191: Simple Communications Blocking support"
8 ---
9
10 ::: {.alert .alert-warning}
11 This module is deprecated as it depends on the deprecated
12 [mod_privacy_lists], use the core module
13 [mod_blocklist][doc:modules:mod_blocklist] instead.
14 :::
15
16 Introduction
17 ============
18
19 Privacy lists are a widely implemented protocol for instructing your
20 server on blocking communications with selected users and services.
21
22 However experience has shown that the power and flexibility of the
23 rule-based system that privacy lists allow is very often much more
24 complex than the user needs, and that in most cases a simple block on
25 all communications to or from a list of specified JIDs would suffice.
26
27 Such a protocol would also allow much simpler user interface design than
28 the current attempts at full privacy list interfaces.
29
30 Details
31 =======
32
33 Simple Communications Blocking was developed to solve the above issues,
34 and allows the client to manage a simple list of blocked JIDs. This
35 plugin implements support for that protocol in Prosody, however the
36 actual blocking is still managed by mod\_privacy, so it is **required**
37 for that plugin to be loaded (this may change in future).
38
39 An XEP-0191 implementation without dependency on mod\_privacy is
40 available in Prosody 0.10 as [mod\_blocklist][doc:modules:mod_blocklist].
41
42 Configuration
43 =============
44
45 Simply ensure that [mod_privacy_lists] and mod_blocking are loaded in
46 your modules_enabled list:
47
48 modules_enabled = {
49 -- ...
50 "privacy_lists",
51 "blocking",
52 -- ...
53
54 Compatibility
55 =============
56
57 ------ ---------------------------------------------
58 0.10 Works but will conflict with mod\_blocklist
59 0.9 Works
60 0.8 Works
61 0.7 Works
62 0.6 Doesn't work
63 ------ ---------------------------------------------