Mercurial > prosody-wiki
comparison mod_muc_config_restrict.wiki @ 354:c8aca35f36df
Created wiki page through web user interface.
| author | MWild1@gmail.com |
|---|---|
| date | Sat, 18 May 2013 21:35:22 +0000 |
| parents | |
| children |
comparison
equal
deleted
inserted
replaced
| 353:2396160dca7c | 354:c8aca35f36df |
|---|---|
| 1 #summary Restrict MUC configuration options to server admins | |
| 2 #labels Stage-Alpha | |
| 3 | |
| 4 = Introduction = | |
| 5 | |
| 6 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. | |
| 7 | |
| 8 For example, using this module you can prevent users from making rooms persistent, or making rooms publicly visible. | |
| 9 | |
| 10 = Details = | |
| 11 | |
| 12 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): | |
| 13 | |
| 14 || *Name* || *Description* || | |
| 15 || muc#roomconfig_roomname || The title/name of the room || | |
| 16 || muc#roomconfig_roomdesc || The description of the room || | |
| 17 || muc#roomconfig_persistentroom || Whether the room should remain when empty || | |
| 18 || muc#roomconfig_publicroom || Whether the room is publicly visible || | |
| 19 || muc#roomconfig_changesubject || Whether occupants can change the subject || | |
| 20 || muc#roomconfig_whois || Control who can see occupant's real JIDs || | |
| 21 || muc#roomconfig_roomsecret || The room password || | |
| 22 || muc#roomconfig_moderatedroom || Whether the room is moderated || | |
| 23 || muc#roomconfig_membersonly || Whether the room is members-only || | |
| 24 || muc#roomconfig_historylength || The length of the room history || | |
| 25 | |
| 26 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. | |
| 27 | |
| 28 = Configuration = | |
| 29 | |
| 30 Enable the plugin on a MUC host (do not put it in your global modules_enabled list): | |
| 31 | |
| 32 {{{ | |
| 33 Component "conference.example.com" "muc" | |
| 34 modules_enabled = { "muc_config_restrict" } | |
| 35 muc_config_restricted = { | |
| 36 "muc#roomconfig_persistentroom"; -- Prevent non-admins from changing a room's persistence setting | |
| 37 "muc#roomconfig_membersonly"; -- Prevent non-admins from changing whether rooms are members-only | |
| 38 } | |
| 39 }}} | |
| 40 | |
| 41 = Compatibility = | |
| 42 || trunk || Works || | |
| 43 || 0.9 || Doesn't work || | |
| 44 || 0.8 || Doesn't work || |