mod_muc_hide_media/README.markdown
author Kim Alvefur <zash@zash.se>
Sat, 02 Mar 2024 14:42:27 +0100
changeset 5854 0358fcf14cd6
parent 4791 df2246b15075
permissions -rw-r--r--
mod_debug_traceback: Remove direct POSIX signal handling, require Prosody 0.12+ Hooking an event is safer than directly hooking signals For context see Prosody trunk rev 69faf3552d52

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