From 86dcbdc41a16e6e092846d20dea08d185084032d Mon Sep 17 00:00:00 2001 From: Catalan Lover <48515417+FSG-Cat@users.noreply.github.com> Date: Sat, 4 May 2024 22:03:42 +0200 Subject: [PATCH] Move Synapse module to new website (#391) * Migrate Synapse module to new docs * [pre-commit.ci] auto fixes from pre-commit.com hooks for more information, see https://pre-commit.ci --------- Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com> --- docs/synapse_module.md | 65 +----------------------------------------- 1 file changed, 1 insertion(+), 64 deletions(-) diff --git a/docs/synapse_module.md b/docs/synapse_module.md index d89fee8d..427b3880 100644 --- a/docs/synapse_module.md +++ b/docs/synapse_module.md @@ -1,64 +1 @@ -**This requires Synapse 1.53.0 or higher** - -Using the bot to manage your rooms is great, however if you want to use your ban lists -(or someone else's) on your server to affect all of your users then a Synapse module -is needed. Primarily meant to block invites from undesired homeservers/users, Mjolnir's -Synapse module is a way to interpret ban lists and apply them to your entire homeserver. - -First, install the module to your Synapse python environment: -``` -pip install -e "git+https://github.com/matrix-org/mjolnir.git#egg=mjolnir&subdirectory=synapse_antispam" -``` - -*Note*: Where your python environment is depends on your installation method. Visit -[#synapse:matrix.org](https://matrix.to/#/#synapse:matrix.org) if you're not sure. - -Then add the following to your `homeserver.yaml`: -```yaml -modules: - - module: mjolnir.Module - config: - # Prevent servers/users in the ban lists from inviting users on this - # server to rooms. Default true. - block_invites: true - # Flag messages sent by servers/users in the ban lists as spam. Currently - # this means that spammy messages will appear as empty to users. Default - # false. - block_messages: false - # Remove users from the user directory search by filtering matrix IDs and - # display names by the entries in the user ban list. Default false. - block_usernames: false - # The room IDs of the ban lists to honour. Unlike other parts of Mjolnir, - # this list cannot be room aliases or permalinks. This server is expected - # to already be joined to the room - Mjolnir will not automatically join - # these rooms. - ban_lists: - - "!roomid:example.org" - #message_max_length: - # Limit the characters in a message (event body) that a client can send in an event on this server. - # By default there is no limit (beyond the the limit the spec enforces on event size). - # Uncomment if you want messages to be limited to 510 characters. - #threshold: 510 - - # Limit messages only in certain rooms rooms. - # By default all rooms will enforce the limit. - # Uncomment if you want messages to only be subject to character limits in certain rooms. - #rooms: - # - "!vMvyOCeCxHsggkmALd:localhost:9999" - - # Also hide messages from remote servers that are over the `message_limit`. - # By default only events from this server will be limited. - # WARNING: Remote users on other servers will still be able to messages over the limit. - # Uncomment to enforce the `message_limit` on events from remote servers. - #remote_servers: true -``` - -*Note*: Although this is described as a "spam checker", it does much more than fight -spam. - -Be sure to change the configuration to match your setup. Your server is expected to -already be participating in the ban lists - if it is not, you will need to have a user -on your homeserver join. The antispam module will not join the rooms for you. - -If you change the configuration, you will need to restart Synapse. You'll also need -to restart Synapse to install the plugin. +This Document has moved to https://the-draupnir-project.github.io/draupnir-documentation/docs/bot/synapse_module