gist/matrix/m.room.join_rules/README.md
2023-03-16 19:53:28 +02:00

135 lines
3.6 KiB
Markdown

<!-- START doctoc generated TOC please keep comment here to allow auto update -->
<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
**Table of Contents** *generated with [DocToc](https://github.com/thlorenz/doctoc)*
- [m.room.join_rules](#mroomjoin_rules)
- [knocking](#knocking)
- [membership of another room](#membership-of-another-room)
- [merging knocking and membership of another room](#merging-knocking-and-membership-of-another-room)
- [Note to self](#note-to-self)
<!-- END doctoc generated TOC please keep comment here to allow auto update -->
# m.room.join_rules
Controls who can join the room. This is best to configure in room settings.
## knocking
Requires room version 7
```json
{
"join_rule": "knock"
}
```
## membership of another room
Requires room version <del>8</del> 9. Offers only Spaces in room settings
```json
{
"allow": [
{
"room_id": "!whatever:example.net",
"type": "m.room_membership"
}
],
"join_rule": "restricted"
}
```
It can be assumed that multiple spaces is simply copying that more,
see below (with exception of `join_rule`)
### merging knocking and membership of another room
Practically the same, but requires room version 10 and new `join_rule` known as
`knock_restricted`
```json
{
"allow": [
{
"room_id": "!ddFNqIRUacwdicInJz:feneas.org",
"type": "m.room_membership"
},
{
"room_id": "!fGtopoZuCySnTsSdsU:matrix.org",
"type": "m.room_membership"
},
{
"room_id": "!IVRSynLjDUQRVOHnbE:pikaviestin.fi",
"type": "m.room_membership"
},
{
"room_id": "!ruWhXaXgrPjaSSecvb:matrix.org",
"type": "m.room_membership"
},
{
"room_id": "!watercooler-v10:maunium.net",
"type": "m.room_membership"
},
{
"room_id": "!etDMqntYVqugEClPcE:artemislena.eu",
"type": "m.room_membership"
},
{
"room_id": "!KMbEUhVQHLwZHmwzKX:matrix.org",
"type": "m.room_membership"
},
{
"room_id": "!rCWNvpCTZHQkiRYUDE:matrix.org",
"type": "m.room_membership"
},
{
"room_id": "!AUKUBkWpbVaNhXJhuD:vi.fi",
"type": "m.room_membership"
},
{
"room_id": "!MHqztrxnQriEOyNLjW:pirateriot.net",
"type": "m.room_membership"
},
{
"room_id": "!WDaMZSVinTZRLOTajM:hacklab.fi",
"type": "m.room_membership"
},
{
"room_id": "!IwPxifXSjBLghpVEMh:matrix.org",
"type": "m.room_membership"
},
{
"room_id": "!iQaStEQNwaqxQfyhZi:sorunome.de",
"type": "m.room_membership"
},
{
"room_id": "!ESKEvwumMpSRZTnJOI:pikaviestin.fi",
"type": "m.room_membership"
},
{
"room_id": "!azROMLeGEMPdbdWnbk:matrix.org",
"type": "m.room_membership"
}
],
"join_rule": "knock_restricted"
}
```
## Note to self
- `!fGtopoZuCySnTsSdsU:matrix.org` - eu.aminda.space v10
- `!ruWhXaXgrPjaSSecvb:matrix.org` - aminda.eu v10
- `!IVRSynLjDUQRVOHnbE:pikaviestin.fi` - Nova Fervoro v10
- `!watercooler-v10:maunium.net` - WaterDuck v10
- `!etDMqntYVqugEClPcE:artemislena.eu` - Community Moderation Effort v9
- `!KMbEUhVQHLwZHmwzKX:matrix.org` - Matrix Haters v9
- `!rCWNvpCTZHQkiRYUDE:matrix.org` - Matrix.fi v5
- `!AUKUBkWpbVaNhXJhuD:vi.fi` - Olohuone v6
- `!MHqztrxnQriEOyNLjW:pirateriot.net` - GlobalPirates v10
- `!WDaMZSVinTZRLOTajM:hacklab.fi` - Matrix Suomi (Space) v6
- `!IwPxifXSjBLghpVEMh:matrix.org` - FluffyChat (room) v5
- `!iQaStEQNwaqxQfyhZi:sorunome.de` - FluffyChat Space v6
- `!ESKEvwumMpSRZTnJOI:pikaviestin.fi` - Piraattipuolue v10
- `!azROMLeGEMPdbdWnbk:matrix.org` - Piraattipuolueen työrauha v9