view mod_muc_hide_media/README.markdown @ 5010:a1f49586d28a

mod_restrict_xmpp: Treat archive query as a read despite using iq-set XEP-0313 uses iq-set to initiate a query, but unlike many other uses of iq-set, this does not mutate anything on the server, so it should not be treated as a write request.
author Kim Alvefur <zash@zash.se>
date Mon, 22 Aug 2022 23:51:07 +0200
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
```