diff mod_muc_anonymize_moderation_actions/README.markdown @ 5941:d58e4c70feb2

mod_muc_anonymize_moderation_actions: first commit.
author John Livingston <git@john-livingston.fr>
date Fri, 26 Jul 2024 17:07:05 +0200
parents
children
line wrap: on
line diff
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/mod_muc_anonymize_moderation_actions/README.markdown	Fri Jul 26 17:07:05 2024 +0200
@@ -0,0 +1,32 @@
+<!--
+SPDX-FileCopyrightText: 2024 John Livingston <https://www.john-livingston.fr/>
+SPDX-License-Identifier: AGPL-3.0-only
+-->
+# mod_muc_anonymize_moderation_actions
+
+This modules allows to anonymize affiliation and role changes in MUC rooms.
+
+Enabling this module on a MUC Virtualhost will add a settings in the roomconfig form.
+When the feature is enabled, when a moderator changes the role or affiliation of an occupant (kick, ban, ...) their name will be removed from the broadcasted message, to not disclose who did the moderation action.
+
+This is particularly usefull to prevent some revenge when a moderator bans someone.
+
+This module is under AGPL-3.0 license.
+
+It was tested on Prosody 0.12.x.
+
+## Configuration
+
+Just enable the module on your MUC VirtualHost.
+The feature will be accessible throught the room configuration form.
+
+You can tweak the position of the settings in the MUC configuration form using `anonymize_moderation_actions_form_position`.
+This value will be passed as priority for the "muc-config-form" hook, so you can move field up by increasing the value, or down by decreasing the value.
+
+By default, the field will be between muc#roomconfig_changesubject and muc#roomconfig_moderatedroom (default value is `78`).
+
+``` lua
+VirtualHost "muc.example.com"
+  modules_enabled = { "muc_anonymize_moderation_actions" }
+  anonymize_moderation_actions_form_position = 96
+```