From 707fb564dea11d9147250c55f59d3a5291334653 Mon Sep 17 00:00:00 2001 From: felixx9 <51174875+felixx9@users.noreply.github.com> Date: Wed, 9 Nov 2022 12:49:20 +0100 Subject: [PATCH 1/3] add how to integrate describe, how to integrate a pad --- docs/configuring-playbook-etherpad.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docs/configuring-playbook-etherpad.md b/docs/configuring-playbook-etherpad.md index 2ea423ef7..c33beb353 100644 --- a/docs/configuring-playbook-etherpad.md +++ b/docs/configuring-playbook-etherpad.md @@ -59,3 +59,7 @@ If you wish to disable the Etherpad chat button, you can do it by appending `?sh If your Etherpad widget fails to load, this might be due to Dimension generating a Pad name so long, the Etherpad app rejects it. `$roomId_$padName` can end up being longer than 50 characters. You can avoid having this problem by altering the template so it only contains the three word random identifier `$padName`. + +## How to use etherpad + +This is how it works in element. It might work similar in other clients: To integrate a standalone etherpad in a room, create your pad, copy the url and send to the room `/addwidget `. You will then find your integrated etherpad within the right sidebar in the `Widgets` section. From 98d2df5fcf1ddfcf6c1b33544c353d154cef8358 Mon Sep 17 00:00:00 2001 From: felixx9 <51174875+felixx9@users.noreply.github.com> Date: Sat, 12 Nov 2022 00:31:39 +0100 Subject: [PATCH 2/3] more details, hopefully better understandable wording. To write docs I need to learn a new language (feels like it) --- docs/configuring-playbook-etherpad.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/docs/configuring-playbook-etherpad.md b/docs/configuring-playbook-etherpad.md index c33beb353..10cd58e0d 100644 --- a/docs/configuring-playbook-etherpad.md +++ b/docs/configuring-playbook-etherpad.md @@ -60,6 +60,8 @@ If you wish to disable the Etherpad chat button, you can do it by appending `?sh If your Etherpad widget fails to load, this might be due to Dimension generating a Pad name so long, the Etherpad app rejects it. `$roomId_$padName` can end up being longer than 50 characters. You can avoid having this problem by altering the template so it only contains the three word random identifier `$padName`. -## How to use etherpad +## How to use Etherpad widgets without an Integration Manager (like Dimension) -This is how it works in element. It might work similar in other clients: To integrate a standalone etherpad in a room, create your pad, copy the url and send to the room `/addwidget `. You will then find your integrated etherpad within the right sidebar in the `Widgets` section. +This is how it works in element, it might work quite similar with other clients: +To integrate a standalone etherpad in a room, create your pad by visiting `https://etherpad.DOMAIN` with your favorite browser and let the magic do the work. When the pad opens, copy the url and send it to the room: `/addwidget `. +You will then find your integrated etherpad within the right sidebar in the `Widgets` section. From 9c2dedfdeb40e845e42e2914f03f47ad9b4f86f8 Mon Sep 17 00:00:00 2001 From: Slavi Pantaleev Date: Wed, 16 Nov 2022 11:56:22 +0200 Subject: [PATCH 3/3] Reorganize a bit --- docs/configuring-playbook-etherpad.md | 13 +++++++------ 1 file changed, 7 insertions(+), 6 deletions(-) diff --git a/docs/configuring-playbook-etherpad.md b/docs/configuring-playbook-etherpad.md index 10cd58e0d..22c782f43 100644 --- a/docs/configuring-playbook-etherpad.md +++ b/docs/configuring-playbook-etherpad.md @@ -41,6 +41,13 @@ If you want to manage and remove old unused pads from Etherpad, you will first n Then from the plugin manager page (`https://etherpad./admin/plugins` or `https://dimension./etherpad/admin/plugins`), install the `adminpads2` plugin. Once installed, you should have a "Manage pads" section in the Admin web-UI. +## How to use Etherpad widgets without an Integration Manager (like Dimension) + +This is how it works in Element, it might work quite similar with other clients: + +To integrate a standalone etherpad in a room, create your pad by visiting `https://etherpad.DOMAIN`. When the pad opens, copy the URL and send a command like this to the room: `/addwidget URL`. You will then find your integrated Etherpad within the right sidebar in the `Widgets` section. + + ## Set Dimension default to the self-hosted Etherpad (optional) If you decided to install [Dimension integration manager](configuring-playbook-dimension.md) alongside Etherpad, the Dimension administrator users can configure the default URL template. @@ -59,9 +66,3 @@ If you wish to disable the Etherpad chat button, you can do it by appending `?sh If your Etherpad widget fails to load, this might be due to Dimension generating a Pad name so long, the Etherpad app rejects it. `$roomId_$padName` can end up being longer than 50 characters. You can avoid having this problem by altering the template so it only contains the three word random identifier `$padName`. - -## How to use Etherpad widgets without an Integration Manager (like Dimension) - -This is how it works in element, it might work quite similar with other clients: -To integrate a standalone etherpad in a room, create your pad by visiting `https://etherpad.DOMAIN` with your favorite browser and let the magic do the work. When the pad opens, copy the url and send it to the room: `/addwidget `. -You will then find your integrated etherpad within the right sidebar in the `Widgets` section.