Software / code / prosody-modules
Annotate
mod_muc_mention_notifications/README.markdown @ 5160:8474a3b80200
mod_firewall: Fix 'is_admin' internal dependency rule #1797 (thanks diane)
Looks like the boolean logic was inverted here. Instead, for now,
simply check if is_admin is there. It is deprecated in trunk and was
briefly removed before being brought back with a 'deprecated' warning as
part of the new roles and permissions work. Making this dependency
conditioned on the existence of the underlying function should make it
work until it actually goes away for real.
| author | Kim Alvefur <zash@zash.se> |
|---|---|
| date | Fri, 27 Jan 2023 23:06:25 +0100 |
| parent | 4314:149ec3abf09e |
| 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 | |
