Mercurial > prosody-modules
changeset 5929:c094eabdb30f
mod_ping_muc: Describe the client facing protocol (from XEP-0045)
| author | Kim Alvefur <zash@zash.se> |
|---|---|
| date | Thu, 11 Jul 2024 15:14:33 +0200 |
| parents | 0b347a7c5b5f |
| children | acd39d33170e |
| files | mod_ping_muc/README.md |
| diffstat | 1 files changed, 21 insertions(+), 0 deletions(-) [+] |
line wrap: on
line diff
--- a/mod_ping_muc/README.md Thu Jul 11 10:15:21 2024 +0100 +++ b/mod_ping_muc/README.md Thu Jul 11 15:14:33 2024 +0200 @@ -35,6 +35,27 @@ } ``` +# Client facing protocol + +If the module determines that the client has dropped out a MUC, +it sends it [a stanza to indicate this](https://xmpp.org/extensions/xep-0045.html#service-error-kick): + +``` xml +<presence type="unavailable" id="random123" from="room@muc.host/nickname" to="user@example.net/resource"> + <x xmlns="http://jabber.org/protocol/muc#user"> + <item affiliation="none" role="none"> + <reason>Connection to remote server lost</reason> + </item> + <status code="110"/> + <status code="330"/> + </x> +</presence> +``` + +The `reason` message may vary. + +Upon receiving this, the client may attempt to [rejoin](https://xmpp.org/extensions/xep-0045.html#enter). + # Compatibility Requires Prosody 0.12.x or trunk