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