diff mod_muc_defaults/README.markdown @ 3586:796b29911747

mod_muc_defaults: Create MUCs from config
author JC Brand <jc@opkode.com>
date Mon, 06 May 2019 16:05:00 +0200
parents
children da2d58208574
line wrap: on
line diff
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/mod_muc_defaults/README.markdown	Mon May 06 16:05:00 2019 +0200
@@ -0,0 +1,37 @@
+# mod_muc_defaults
+
+Creates MUCs with default configuration settings upon Prosody startup.
+
+## Configuration
+
+Under your MUC component, add a `default_mucs` option with the relevant settings.
+
+```
+Component "conference.example.org" "muc"
+   modules_enabled = {
+            "muc_defaults";
+   }
+
+   default_mucs = {
+      {
+         jid_node = "trollbox",
+         affiliations = {
+                  admin = { "admin@example.org", "superuser@example.org" },
+                  owner = { "owner@example.org" },
+                  visitors = { "visitor@example.org" }
+         },
+         config = {
+                  allow_member_invites = false,
+                  change_subject = false,
+                  history_length = 40,
+                  language = "en",
+                  logging = true,
+                  members_only = false,
+                  moderated = false,
+                  persistent = true,
+                  public = true,
+                  public_jids = true
+         }
+      }
+   };
+```