# HG changeset patch
# User NKNeumann@gmail.com
# Date 1424457017 0
# Node ID ad9071a3062c13f87d72062cbe4460a573ee0be2
# Parent  049ad0dda0d189a8ee3119b0437386cc6e5de15a
Created wiki page through web user interface.

diff -r 049ad0dda0d1 -r ad9071a3062c mod_muc_restrict_rooms.wiki
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/mod_muc_restrict_rooms.wiki	Fri Feb 20 18:30:17 2015 +0000
@@ -0,0 +1,36 @@
+#summary Regexp based room restriction module
+
+= Introduction =
+
+This module allows disabling room creation based on regexp patterns defined in configuration. 
+
+= Dependencies =
+
+This module depends on *muc/rooms* module. If *muc/rooms* is not loaded, this module won't work.
+
+= How to load the module =
+
+Copy the module to the prosody modules/plugins directory.
+
+In Prosody's configuration file, under the desired host section, add:
+{{{
+  modules_enabled = {
+    ...
+    "mod_muc_restrict_rooms";
+    ...
+  }
+}}}
+
+= Configuration =
+
+*mod_muc_restrict_rooms* has several variables which let you configure the patterns for room names you want to ban, establish exceptions for those patterns and even deciding whether admins can or not bypass the prohibition.
+
+|| *Name*                  || *Description*                                      || *Example*   || *Default value*  ||
+|| muc_restrict_matching   || Table in the key/value format (keys for patterns and values for reasons) that determines which rooms shouldn't be created. The key is a regexp and must be specified between quotation marks (see example). Room names will be evaluated always lowercase, so define your patterns taking this into consideration. || muc_restrict_matching = { ["^admin"] = "Rooms that start with 'admin' are reserved for staff use only" } || {} ||
+|| muc_restrict_exceptions || String format table that contains exceptions to the above defined rules. Room names specified here will bypass the **muc_restrict_matching** restrictions and will be available for anyone || muc_restrict_exceptions = { "admins_are_good", "admins_rocks" } || {} ||
+|| muc_restrict_allow_admins || Boolean that determines whether users in the *admin* table are able to bypass any room restriction. If ser to _true_, they will be able to bypass those rules. || muc_restrict_allow_admins = true || false ||
+
+= Compatibility =
+
+|| 0.9 || Works ||
+|| 0.8 || Should work ||
\ No newline at end of file