27 lines
1.4 KiB
Markdown
27 lines
1.4 KiB
Markdown
|
# Setting up Etherpad (optional)
|
||
|
|
|
||
|
|
[Etherpad](https://etherpad.org) is is an open source collaborative text editor that can be embedded in a Matrix chat room using the [Dimension integrations manager](https://dimension.t2bot.io)
|
||
|
|
|
||
|
|
When enabled together with Jitsi, it will be made available as an option during the conferences.
|
||
|
|
|
||
|
|
## Prerequisites
|
||
|
|
|
||
|
|
For the self-hosted Etherpad instance to be available to your users, you must first enable and configure the **Dimension integrations manager** as described in [the playbook documentation](configuring-playbook-dimension.md)
|
||
|
|
|
||
|
|
## Enable
|
||
|
|
|
||
|
|
[Etherpad](https://etherpad.org) installation is disabled by default. You can enable it in your configuration file (`inventory/host_vars/matrix.<your-domain>/vars.yml`):
|
||
|
|
|
||
|
|
```yaml
|
||
|
|
matrix_etherpad_enabled: true
|
||
|
|
```
|
||
|
|
|
||
|
|
## Set Dimension default to the self-hosted Etherpad
|
||
|
|
|
||
|
|
The Dimension administrator users can configure the default URL template. The Dimension configuration menu can be accessed with the sprocket icon as you begin to add a widget to a room in Element. There you will find the Etherpad Widget Configuration action beneath the _Widgets_ tab. Replace `scalar.vector.im` with your own Dimension domain.
|
||
|
|
|
||
|
|
### Removing the integrated Etherpad chat
|
||
|
|
|
||
|
|
If you wish to disable the Etherpad chat button, you can do it by appending `?showChat=false` to the end of the pad URL, or the template.
|
||
|
|
Example: `https://dimension.<your-domain>/etherpad/p/$roomId_$padName?showChat=false`
|