Diff

mod_muc_defaults/README.md @ 6211:750d64c47ec6 draft default tip

Merge
author Trần H. Trung <xmpp:trần.h.trung@trung.fun>
date Tue, 18 Mar 2025 00:31:36 +0700
parent 6003:fe081789f7b5
line wrap: on
line diff
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/mod_muc_defaults/README.md	Tue Mar 18 00:31:36 2025 +0700
@@ -0,0 +1,39 @@
+# 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 = {
+                  name = "General Chat",
+                  description = "Public chatroom with no particular topic",
+                  allow_member_invites = false,
+                  change_subject = false,
+                  history_length = 40,
+                  lang = "en",
+                  logging = true,
+                  members_only = false,
+                  moderated = false,
+                  persistent = true,
+                  public = true,
+                  public_jids = true
+         }
+      }
+   };
+```