annotate mod_unsubscriber/README.md @ 6519:01d8bfbfc435

mod_pubsub_serverinfo: Fix check for local domain The module was checking whether a host exists, but this may be misleading if our host is loaded before the host that is being checked. This change makes it check the config. This will provide a false positive in the rare case that the host is defined but not activated/enabled. But we don't have an API currently for "is this host configured and enabled?"
author Matthew Wild <mwild1@gmail.com>
date Tue, 21 Apr 2026 19:54:19 +0100
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 ```