Mercurial > prosody-modules

annotate mod_unsubscriber/README.md @ 6562:5da6fb562df9 default tip

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
mod_unified_push: Fix push error handling (fixes #2000) Use the error object that send_iq() passes as an argument to it's reject callback instead of attempting and failing to do the parsing in the callback itself.
author kmq
date Mon, 06 Jul 2026 14:23:57 +0200
parents 9c9889ad4302
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
6398
9c9889ad4302 mod_unsubscriber: Add MUC support
Kim Alvefur <zash@zash.se>
parents: 6156
diff changeset
1 Over the years, some servers stop working for various reasons, and leave behind broken roster subscriptions and dysfunctional group chat bookmarks
9c9889ad4302 mod_unsubscriber: Add MUC support
Kim Alvefur <zash@zash.se>
parents: 6156
diff changeset
2 that trigger failing s2s connections. Sometimes users make mistakes when adding a contact or group chat, causing your server to make repeated attempts
9c9889ad4302 mod_unsubscriber: Add MUC support
Kim Alvefur <zash@zash.se>
parents: 6156
diff changeset
3 to connect to a domain with a typo in it.
9c9889ad4302 mod_unsubscriber: Add MUC support
Kim Alvefur <zash@zash.se>
parents: 6156
diff changeset
4
5168
e00dc913d965 mod_unsubscriber: Revoke roster subscriptions of unreachable hosts
Kim Alvefur <zash@zash.se>
parents:
diff changeset
5 This module allows cleaning up such cases by unsubscribing local users
6398
9c9889ad4302 mod_unsubscriber: Add MUC support
Kim Alvefur <zash@zash.se>
parents: 6156
diff changeset
6 from their contacts on those servers.
5168
e00dc913d965 mod_unsubscriber: Revoke roster subscriptions of unreachable hosts
Kim Alvefur <zash@zash.se>
parents:
diff changeset
7 Use with care.
e00dc913d965 mod_unsubscriber: Revoke roster subscriptions of unreachable hosts
Kim Alvefur <zash@zash.se>
parents:
diff changeset
8
6398
9c9889ad4302 mod_unsubscriber: Add MUC support
Kim Alvefur <zash@zash.se>
parents: 6156
diff changeset
9 To use, simply add as a `Component` for each domain you want to stop seeing failed connection logs about.
9c9889ad4302 mod_unsubscriber: Add MUC support
Kim Alvefur <zash@zash.se>
parents: 6156
diff changeset
10
9c9889ad4302 mod_unsubscriber: Add MUC support
Kim Alvefur <zash@zash.se>
parents: 6156
diff changeset
11 ``` lua
5168
e00dc913d965 mod_unsubscriber: Revoke roster subscriptions of unreachable hosts
Kim Alvefur <zash@zash.se>
parents:
diff changeset
12 Component "gmail.com" "unsubscriber"
6156
56d1e059f68c mod_unsubscriber: Add disabling mod_s2s to example
Kim Alvefur <zash@zash.se>
parents: 5168
diff changeset
13 modules_disabled = { "s2s" }
5168
e00dc913d965 mod_unsubscriber: Revoke roster subscriptions of unreachable hosts
Kim Alvefur <zash@zash.se>
parents:
diff changeset
14 ```