mod_muc_auto_hats

Introduction

This module lets you dynamically assign hats to MUC occupants based on configuration rules.

Currently the only supported rule type is based on the host that the user is joining from. More rule types may be added in the future.

Configuration

Add the module to the MUC host (not the global modules_enabled):

        Component "conference.example.com" "muc"
            modules_enabled = { "muc_auto_hats" }

Then add configuration rules.

Hats are identified by URIs, which must be unique (they are not displayed to the user). If you don’t specify one, Prosody will generate a unique one for you. Each hat also has a human-readable ‘title’. Again, Prosody will generate a default if you don’t specify one.

By user host

muc_auto_hats_by_host = {
    ["anon.example.com"] = {
        title = "Web chat";
    };
    ["staff.example.com"] = {
        title = "Staff";
        uri = "https://example.com/roles/staff";
    };
}

Compatibility

Requires Prosody 13.0+

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