add guide about matrix room creation
This commit is contained in:
parent
6a1caed856
commit
8f07ad8ca4
1 changed files with 53 additions and 0 deletions
53
docs/guides/matrix-create-room.md
Normal file
53
docs/guides/matrix-create-room.md
Normal file
|
|
@ -0,0 +1,53 @@
|
|||
---
|
||||
title: "Matrix: Create a New Room"
|
||||
---
|
||||
|
||||
# Matrix: Create a New Room
|
||||
|
||||
!!! success "Goal"
|
||||
|
||||
Create a new matrix room for a CCCHH group or function with correct protections and permissions
|
||||
|
||||
## 1. Create the Room
|
||||
|
||||
Rooms are always created by the *CCCHH-Admin* Account whose credentials can be found in *infra-secrets*.
|
||||
To create a room, log in to https://element.hamburg.ccc.de and click on *New Conversation* -> *New Room*.
|
||||
Enter a Room Name and optionally give it an address on the *hamburg.ccc.de* server.
|
||||
|
||||
## 2. Configure Room Metadata
|
||||
|
||||
Once the room is created, please give it a topic and if possible a room icon.
|
||||
This makes it easier to distinguish the many rooms we have.
|
||||
|
||||
## 3. Invite the Moderation-Bot
|
||||
|
||||
Either perform the following steps via the GUI or enter the displayed commands into the chat window of the new room:
|
||||
|
||||
|
||||
1. Invite the User `@moderation:hamburg.ccc.de` to the new room
|
||||
```
|
||||
/invite @moderation:hamburg.ccc.de
|
||||
```
|
||||
|
||||
2. Give the moderation bot *Admin* Power-Level so that it can properly enforce all protections
|
||||
```
|
||||
/op @moderation:hamburg.ccc.de 100
|
||||
```
|
||||
|
||||
## 4. Set Up Room Protection
|
||||
|
||||
We have now added the moderation bot to the room but this is not enough.
|
||||
The bot needs to be told explicitly which rooms it should protect and the newly created one therefore needs to be added to that list.
|
||||
|
||||
First, note down the *Internal Room ID* which can be found in the new Rooms settings under the *Advanced* tab.
|
||||
Then enter the *CCCHH Moderation Management* room and write the follogin mjolnir command while substituting the copied room id:
|
||||
|
||||
```
|
||||
!mjolnir rooms add <room-id>
|
||||
```
|
||||
|
||||
## Closing Up
|
||||
|
||||
You should now have a new Matrix Room under moderation protection.
|
||||
To verify that everything was done correctly, you can enter `!mjolnir verify` in the *CCCHH Moderation Management* room and observe that the moderation bot does not give you an error.
|
||||
|
||||
Loading…
Reference in a new issue