prosody-modules
d611ed13df7e
mod_blocking/README.md

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.md @ 6209:d611ed13df7e draft

Merge
author Trần H. Trung <xmpp:trần.h.trung@trung.fun>
date Tue, 18 Mar 2025 00:16:25 +0700
parent 5861:mod_blocking/README.markdown@7d11a3133d17
comparison
equal deleted inserted replaced
6208:e20901443eae 6209:d611ed13df7e
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 ------ ---------------------------------------------