view mod_muc_defaults/README.markdown @ 4983:7c77058a1ac5

mod_compat_roles: New module providing compat shim for trunk's new role API The new role API is translated to is_admin() calls on older versions. On newer versions (which have the role API) this module does nothing. It allows modules to drop their use of is_admin() (which is not available in trunk) and switch to the new role API, while remaining compatible with previous Prosody versions.
author Matthew Wild <mwild1@gmail.com>
date Thu, 11 Aug 2022 17:49:33 +0100
parents 22784f001b7f
children a1f8cc591b66
line wrap: on
line source

# mod_muc_defaults

Creates MUCs with default configuration settings upon Prosody startup.

## Configuration

Under your MUC component, add a `muc_defaults` option with the relevant settings.

```
Component "conference.example.org" "muc"
   modules_enabled = {
            "muc_defaults";
   }

   muc_defaults = {
      {
         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
         }
      }
   };
```