Mercurial > prosody-modules

annotate mod_muc_mention_notifications/README.markdown @ 4530:33c149d0261d

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
mod_rest: Add mappings for a whole pile of XEPs Look ma, programming in JSON! XEP-0012: Last Activity XEP-0077: In-Band Registration XEP-0115: Entity Capabilities XEP-0153: vCard-Based Avatars XEP-0297: Stanza Forwarding XEP-0308: Last Message Correction XEP-0319: Last User Interaction in Presence XEP-0333: Chat Markers XEP-0367: Message Attaching XEP-0372: References XEP-0421: Anonymous unique occupant identifiers for MUCs XEP-0428: Fallback Indication XEP-0444: Message Reactions
author Kim Alvefur <zash@zash.se>
date Tue, 23 Mar 2021 23:18:33 +0100
parents 149ec3abf09e
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
4280
278f2998ce49 mod_muc_room_mention_notifications: Publish module
Seve Ferrer <seve@delape.net>
parents:
diff changeset
1 # Configuring
278f2998ce49 mod_muc_room_mention_notifications: Publish module
Seve Ferrer <seve@delape.net>
parents:
diff changeset
2
4314
149ec3abf09e mod_muc_mention_notifications: Add description in readme
JC Brand <jc@opkode.com>
parents: 4307
diff changeset
3 This module lets Prosody notify users when they're mentioned in a MUC, even if they're not currently present in it.
149ec3abf09e mod_muc_mention_notifications: Add description in readme
JC Brand <jc@opkode.com>
parents: 4307
diff changeset
4
149ec3abf09e mod_muc_mention_notifications: Add description in readme
JC Brand <jc@opkode.com>
parents: 4307
diff changeset
5 Users need to be explicitly mentioned via XEP-0372 references.
149ec3abf09e mod_muc_mention_notifications: Add description in readme
JC Brand <jc@opkode.com>
parents: 4307
diff changeset
6
149ec3abf09e mod_muc_mention_notifications: Add description in readme
JC Brand <jc@opkode.com>
parents: 4307
diff changeset
7 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.
149ec3abf09e mod_muc_mention_notifications: Add description in readme
JC Brand <jc@opkode.com>
parents: 4307
diff changeset
8
149ec3abf09e mod_muc_mention_notifications: Add description in readme
JC Brand <jc@opkode.com>
parents: 4307
diff changeset
9 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).
149ec3abf09e mod_muc_mention_notifications: Add description in readme
JC Brand <jc@opkode.com>
parents: 4307
diff changeset
10
4280
278f2998ce49 mod_muc_room_mention_notifications: Publish module
Seve Ferrer <seve@delape.net>
parents:
diff changeset
11 ## Enabling
278f2998ce49 mod_muc_room_mention_notifications: Publish module
Seve Ferrer <seve@delape.net>
parents:
diff changeset
12
278f2998ce49 mod_muc_room_mention_notifications: Publish module
Seve Ferrer <seve@delape.net>
parents:
diff changeset
13 ``` {.lua}
278f2998ce49 mod_muc_room_mention_notifications: Publish module
Seve Ferrer <seve@delape.net>
parents:
diff changeset
14 Component "rooms.example.net" "muc"
278f2998ce49 mod_muc_room_mention_notifications: Publish module
Seve Ferrer <seve@delape.net>
parents:
diff changeset
15 modules_enabled = {
4307
af7297e49885 muc_mention_notifications: Rename module
JC Brand <jc@opkode.com>
parents: 4280
diff changeset
16 "muc_mention_notifications";
4280
278f2998ce49 mod_muc_room_mention_notifications: Publish module
Seve Ferrer <seve@delape.net>
parents:
diff changeset
17 }
278f2998ce49 mod_muc_room_mention_notifications: Publish module
Seve Ferrer <seve@delape.net>
parents:
diff changeset
18 ```
278f2998ce49 mod_muc_room_mention_notifications: Publish module
Seve Ferrer <seve@delape.net>
parents:
diff changeset
19
278f2998ce49 mod_muc_room_mention_notifications: Publish module
Seve Ferrer <seve@delape.net>
parents:
diff changeset
20 ## Settings
278f2998ce49 mod_muc_room_mention_notifications: Publish module
Seve Ferrer <seve@delape.net>
parents:
diff changeset
21
278f2998ce49 mod_muc_room_mention_notifications: Publish module
Seve Ferrer <seve@delape.net>
parents:
diff changeset
22 |Name |Description |Default |
278f2998ce49 mod_muc_room_mention_notifications: Publish module
Seve Ferrer <seve@delape.net>
parents:
diff changeset
23 |-----|------------|--------|
4307
af7297e49885 muc_mention_notifications: Rename module
JC Brand <jc@opkode.com>
parents: 4280
diff changeset
24 |muc_mmn_notify_unaffiliated_users| Notify mentioned users even if they are not members of the room they were mentioned in | false |