mirror of
https://github.com/element-hq/synapse.git
synced 2024-12-14 11:57:44 +00:00
Improve default_power_level_content_override documentation (#17451)
Co-authored-by: Andrew Morgan <1342360+anoadragon453@users.noreply.github.com>
This commit is contained in:
parent
f583f1dce4
commit
6a01af59e1
3 changed files with 35 additions and 0 deletions
1
changelog.d/17451.doc
Normal file
1
changelog.d/17451.doc
Normal file
|
@ -0,0 +1 @@
|
||||||
|
Improve documentation for the [`default_power_level_content_override`](https://element-hq.github.io/synapse/latest/usage/configuration/config_documentation.html#default_power_level_content_override) config option.
|
|
@ -4134,6 +4134,38 @@ default_power_level_content_override:
|
||||||
trusted_private_chat: null
|
trusted_private_chat: null
|
||||||
public_chat: null
|
public_chat: null
|
||||||
```
|
```
|
||||||
|
|
||||||
|
The default power levels for each preset are:
|
||||||
|
```yaml
|
||||||
|
"m.room.name": 50
|
||||||
|
"m.room.power_levels": 100
|
||||||
|
"m.room.history_visibility": 100
|
||||||
|
"m.room.canonical_alias": 50
|
||||||
|
"m.room.avatar": 50
|
||||||
|
"m.room.tombstone": 100
|
||||||
|
"m.room.server_acl": 100
|
||||||
|
"m.room.encryption": 100
|
||||||
|
```
|
||||||
|
|
||||||
|
So a complete example where the default power-levels for a preset are maintained
|
||||||
|
but the power level for a new key is set is:
|
||||||
|
```yaml
|
||||||
|
default_power_level_content_override:
|
||||||
|
private_chat:
|
||||||
|
events:
|
||||||
|
"com.example.foo": 0
|
||||||
|
"m.room.name": 50
|
||||||
|
"m.room.power_levels": 100
|
||||||
|
"m.room.history_visibility": 100
|
||||||
|
"m.room.canonical_alias": 50
|
||||||
|
"m.room.avatar": 50
|
||||||
|
"m.room.tombstone": 100
|
||||||
|
"m.room.server_acl": 100
|
||||||
|
"m.room.encryption": 100
|
||||||
|
trusted_private_chat: null
|
||||||
|
public_chat: null
|
||||||
|
```
|
||||||
|
|
||||||
---
|
---
|
||||||
### `forget_rooms_on_leave`
|
### `forget_rooms_on_leave`
|
||||||
|
|
||||||
|
|
|
@ -1188,6 +1188,8 @@ class RoomCreationHandler:
|
||||||
)
|
)
|
||||||
events_to_send.append((power_event, power_context))
|
events_to_send.append((power_event, power_context))
|
||||||
else:
|
else:
|
||||||
|
# Please update the docs for `default_power_level_content_override` when
|
||||||
|
# updating the `events` dict below
|
||||||
power_level_content: JsonDict = {
|
power_level_content: JsonDict = {
|
||||||
"users": {creator_id: 100},
|
"users": {creator_id: 100},
|
||||||
"users_default": 0,
|
"users_default": 0,
|
||||||
|
|
Loading…
Reference in a new issue