Mercurial > prosody-modules
annotate mod_muc_mention_notifications/README.markdown @ 4579:b305814bd930
mod_muc_dicebot: A thing to roll dice
Do you see what happens, Jitsi? Do you see what happens when you
make it hard for me to use a proper bot? This is what happens,
Jitsi. This is what happens when you meet a stranger in the alps!
Ahem. In all seriousness, this is more of a quick hack than
anything else. It will look for `.r` in MUC messages and if it
finds it, it'll interpret it as an instruction to roll a few
dice. Injects the results in the body of the message. Eats the
message alive if it is malformed.
author | Jonas Schäfer <jonas@wielicki.name> |
---|---|
date | Sat, 29 May 2021 15:17:05 +0200 |
parents | 149ec3abf09e |
children |
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 | |