view mod_muc_config_restrict.wiki @ 455:5f111a4e13fb

mod_s2s_auth_dane.wiki: drep mention of luajit, not required anymore
author Kim Alvefur <zash@zash.se>
date Mon, 19 May 2014 11:28:47 +0200
parents c8aca35f36df
children
line wrap: on
line source

#summary Restrict MUC configuration options to server admins
#labels Stage-Alpha

= Introduction =

Sometimes, especially on public services, you may want to allow people to create their own rooms, but prevent some options from being modified by normal users.

For example, using this module you can prevent users from making rooms persistent, or making rooms publicly visible.

= Details =

You need to supply a list of options that will be restricted to admins. Available options can vary, but the following table lists Prosody's built-in options (as defined in XEP-0045):

|| *Name* || *Description* ||
|| muc#roomconfig_roomname || The title/name of the room ||
|| muc#roomconfig_roomdesc || The description of the room ||
|| muc#roomconfig_persistentroom || Whether the room should remain when empty ||
|| muc#roomconfig_publicroom || Whether the room is publicly visible ||
|| muc#roomconfig_changesubject || Whether occupants can change the subject ||
|| muc#roomconfig_whois || Control who can see occupant's real JIDs ||
|| muc#roomconfig_roomsecret || The room password ||
|| muc#roomconfig_moderatedroom || Whether the room is moderated ||
|| muc#roomconfig_membersonly || Whether the room is members-only ||
|| muc#roomconfig_historylength || The length of the room history ||

Some plugins may add other options to the room config (in Prosody 0.10+), for which you will need to consult their documentation for the full option name.

= Configuration =

Enable the plugin on a MUC host (do not put it in your global modules_enabled list):

{{{
    Component "conference.example.com" "muc"
        modules_enabled = { "muc_config_restrict" }
        muc_config_restricted = {
            "muc#roomconfig_persistentroom"; -- Prevent non-admins from changing a room's persistence setting
            "muc#roomconfig_membersonly"; -- Prevent non-admins from changing whether rooms are members-only
        }
}}}

= Compatibility =
|| trunk || Works ||
|| 0.9 || Doesn't work ||
|| 0.8 || Doesn't work ||