From 53fc3657bdad9a3c88917ae8cadb628cf3cea878 Mon Sep 17 00:00:00 2001 From: gravel Date: Sat, 9 Nov 2024 08:48:40 +0000 Subject: [PATCH] docs: recommend pysogs sql triggers --- for-sogops.md | 20 +++++++++++++++++++- 1 file changed, 19 insertions(+), 1 deletion(-) diff --git a/for-sogops.md b/for-sogops.md index 6f5c3fc..a9b0c93 100644 --- a/for-sogops.md +++ b/for-sogops.md @@ -5,6 +5,7 @@ - [Communication channels](#communication-channels) - [Moderating abuse](#moderating-abuse) - [Disabling attachments](#disabling-attachments) + - [**PySOGS SQL Triggers (recommended)**](#pysogs-sql-triggers-recommended) - [Limiting Direct Messages](#limiting-direct-messages) - [Filtering abusive language](#filtering-abusive-language) - [Additional moderator tools](#additional-moderator-tools) @@ -41,10 +42,27 @@ sogs --rooms "MY_ROOM_ID" --remove-perms u Replace `MY_ROOM_ID` with `*` (asterisk) to apply this change to all Communities on your server. +If you do not have access to the server command line, see [Additional Moderator Tools](#additional-moderator-tools) instead. + **Side effects**: - Link previews and replies to media messages can no longer be sent by regular users. -- Access to the command line is necessary to grant the upload permission to individual users: `sogs --rooms MY_ROOM_ID --add-perms u --users USER_SESSION_ID`. +- Access to the command line (or [other tools](#additional-moderator-tools)) are necessary to grant the upload permission to individual users: `sogs --rooms MY_ROOM_ID --add-perms u --users USER_SESSION_ID`. + +### PySOGS SQL Triggers (recommended) + +The [PySOGS SQL Triggers](https://codeberg.org/gravel/pysogs-sql-triggers) are a set of database modifications compiled by `gravel` for the Session Open Group Server. + +The SQL triggers provide additional features to Communities, such as anti-abuse measures and other utilities. + +Features of the SQL triggers include: + +- Setting restrictions on new user activity +- Setting restrictions on direct messaging activity +- Use of the `!lockdown` and `!endlockdown` chat commands +- Use of the `!requestrole uploader` and `!requestrole moderator` chat commands + +The SQL triggers are both *customizable* and *reversible* by design, and were developed for use with the [PySOGS SQL Manager](https://codeberg.org/gravel/pysogs-sql-cli). For installation instructions, see [pysogs-sql-triggers#Installation](https://codeberg.org/gravel/pysogs-sql-triggers#installation). Note that the PostgreSQL database is not supported at this time. ### Limiting Direct Messages