prosody-modules
dad0367d33e8
mod_muc_mention_notifications/README.markdown

Find changesets by keywords by author, files, the commit message, revision number or hash, or revset expression.

Software / code / prosody-modules

File

mod_muc_mention_notifications/README.markdown @ 4480:dad0367d33e8

mod_rest: Revert leftover of unfinished ?query mapping Idea was to allow second level data fields to be passed as query parameters, i.e. /rest/command/{to}/?command=execute&node=foobar but that's still a work in progress, so reverted here for now.
author Kim Alvefur <zash@zash.se>
date Sun, 28 Feb 2021 20:59:53 +0100
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 |