Software /
code /
prosody-modules
File
mod_muc_mention_notifications/README.markdown @ 4941:e7b9bc629ecc
mod_rest: Add special handling to catch MAM results from remote hosts
Makes MAM queries to remote hosts works.
As the comment says, MAM results from users' local archives or local
MUCs are returned via origin.send() which is provided in the event and
thus already worked. Results from remote hosts go via normal stanza
routing and events, which need this extra handling to catch.
This pattern of iq-set, message+, iq-result is generally limited to MAM.
Closest similar thing might be MUC join, but to really handle that you
would need the webhook callback mechanism.
author | Kim Alvefur <zash@zash.se> |
---|---|
date | Mon, 16 May 2022 19:47:09 +0200 |
parent | 4314:149ec3abf09e |
line wrap: on
line source
# Configuring This module lets Prosody notify users when they're mentioned in a MUC, even if they're not currently present in it. Users need to be explicitly mentioned via XEP-0372 references. In anonymous and semi-anonymous rooms, the mentioned user needs to have their nickname registered in the MUC so that Prosody can get the real JID from the referenced nickname. NOTE: this module is not compatible with mod_block_strangers because the latter will block the notification messages from the MUC (since they're not "groupchat" messages). ## Enabling ``` {.lua} Component "rooms.example.net" "muc" modules_enabled = { "muc_mention_notifications"; } ``` ## Settings |Name |Description |Default | |-----|------------|--------| |muc_mmn_notify_unaffiliated_users| Notify mentioned users even if they are not members of the room they were mentioned in | false |