|
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 || |