matrix-docker-ansible-deploy/docs/configuring-playbook-etherpad.md
2021-01-26 05:04:47 +01:00

1.4 KiB

Setting up Etherpad (optional)

Etherpad is is an open source collaborative text editor that can be embedded in a Matrix chat room using the Dimension integrations manager

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

Enable

Etherpad installation is disabled by default. You can enable it in your configuration file (inventory/host_vars/matrix.<your-domain>/vars.yml):

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