view mod_muc_hide_media/README.markdown @ 5158:ca7feb293d55

mod_inject_ecaps2: Mention and link to XEP-0390 in text This should get the module browsing website to notice and include this module in the list-by-XEP page.
author Kim Alvefur <zash@zash.se>
date Mon, 16 Jan 2023 15:54:40 +0100
parents df2246b15075
children
line wrap: on
line source

# Introduction

This module adds a room configuration option to hide inline media from MUCs and
display them as links instead.

This can be useful in public channels where content posted by users should not
be shown by default.

**Note:** You could consider the more useful [mod_muc_restrict_media] instead,
which allows affiliated users (e.g. members, admins, owners) to still send
inline media.

# Configuring

## Enabling

``` {.lua}
Component "rooms.example.net" "muc"
modules_enabled = {
    "muc_hide_media";
}
```

## Settings

A default setting can be provided in the config file:

``` {.lua}
muc_room_default_hide_media = true
```