view mod_muc_defaults/README.md @ 6208:303fcfe3a7e8

mod_conversejs: Make PWA options match documentation Keeps fallback to `name` because this is a common option used by e.g. mod_disco to give a descriptive name for the server itself, which seems a sensible default.
author Kim Alvefur <zash@zash.se>
date Sun, 20 Apr 2025 13:37:15 +0200
parents fe081789f7b5
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
         }
      }
   };
```