diff mod_muc_restrict_media/README.markdown @ 4787:df2246b15075

mod_muc_restrict_media: Allow hiding inline media from unaffiliated users in MUCs
author Matthew Wild <mwild1@gmail.com>
date Tue, 23 Nov 2021 17:14:25 +0000
parents
children
line wrap: on
line diff
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/mod_muc_restrict_media/README.markdown	Tue Nov 23 17:14:25 2021 +0000
@@ -0,0 +1,26 @@
+# Introduction
+
+This module adds a room configuration option to hide inline media from
+unaffiliated users in 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.
+
+# Configuring
+
+## Enabling
+
+``` {.lua}
+Component "rooms.example.net" "muc"
+modules_enabled = {
+    "muc_restrict_media";
+}
+```
+
+## Settings
+
+A default setting can be provided in the config file:
+
+``` {.lua}
+muc_room_default_restrict_media = true
+```