view mod_muc_defaults/README.markdown @ 5907:d194d1012fd3

Updating dox for mod_rest. Ideas expressed / clarified: 1) Making clear that mod_rest isn't to be installed under VirtualHosts AND as a component. 2) Understanding some of the implications of this choice: A) Changes to user authentication B) How it affects subdomains 3) More consistent use of domain names for clarity. 4) Using different heading sizes to show scope of section. Essentially, I added all the tidbits I had to clarify in getting this to work in my own example.
author Ben Smith <bens@effortlessis.com>
date Mon, 13 May 2024 13:25:13 -0700
parents a1f8cc591b66
children
line wrap: on
line source

# 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
         }
      }
   };
```