Mercurial > prosody-modules
view mod_blocking/README.markdown @ 5852:133b23758cf6
mod_log_ringbuffer: Hook POSIX signals via event only
author | Kim Alvefur <zash@zash.se> |
---|---|
date | Sat, 02 Mar 2024 15:11:20 +0100 |
parents | 7d11a3133d17 |
children |
line wrap: on
line source
--- labels: - Stage-Deprecated rockspec: dependencies: - mod_privacy_lists summary: "XEP-0191: Simple Communications Blocking support" --- ::: {.alert .alert-warning} This module is deprecated as it depends on the deprecated [mod_privacy_lists], use the core module [mod_blocklist][doc:modules:mod_blocklist] instead. ::: Introduction ============ Privacy lists are a widely implemented protocol for instructing your server on blocking communications with selected users and services. However experience has shown that the power and flexibility of the rule-based system that privacy lists allow is very often much more complex than the user needs, and that in most cases a simple block on all communications to or from a list of specified JIDs would suffice. Such a protocol would also allow much simpler user interface design than the current attempts at full privacy list interfaces. Details ======= Simple Communications Blocking was developed to solve the above issues, and allows the client to manage a simple list of blocked JIDs. This plugin implements support for that protocol in Prosody, however the actual blocking is still managed by mod\_privacy, so it is **required** for that plugin to be loaded (this may change in future). An XEP-0191 implementation without dependency on mod\_privacy is available in Prosody 0.10 as [mod\_blocklist][doc:modules:mod_blocklist]. Configuration ============= Simply ensure that [mod_privacy_lists] and mod_blocking are loaded in your modules_enabled list: modules_enabled = { -- ... "privacy_lists", "blocking", -- ... Compatibility ============= ------ --------------------------------------------- 0.10 Works but will conflict with mod\_blocklist 0.9 Works 0.8 Works 0.7 Works 0.6 Doesn't work ------ ---------------------------------------------