mod_muc_notifications

Introduction

This module listens to MUC messages and sends a notification to the MUC members not present in the MUC at that moment.

By default, the notification will be a message with a simple text as body.

By sending this “out-of-MUC” notification, not-joined members will be able to know that new messages are available.

Usage

First copy the module to the prosody plugins directory.

Then add “muc_notifications” to your modules_enabled list in your MUC component:

Component "conference.example.org" "muc"
modules_enabled = {
    "muc_notifications",
}

You may also want to enable “offline_hints” module so the notification messages sent by this module are not added to the offline storage for later delivery.

Configuration

Option Description
muc_notification_invite If set to true, the notification sent will take the form of a MUC invite. (default: false)

Installation

With the plugin installer in Prosody 0.12 you can use:

sudo prosodyctl install --server=https://modules.prosody.im/rocks/ mod_muc_notifications

For earlier versions see the documentation for installing 3rd party modules