4Etherpad-Lite plugin for dokuwiki
6All documentation for this plugin can be found at https://github.com/michael-dev/dokuwikietherpadlite and at https://www.dokuwiki.org/plugin:etherpadlite .
8What does it do?
11This dokuwiki plugin lets you edit your pages using an existing etherpad lite instance. Using an appropiate configuration of the etherpad lite server, the plugin will enforce dokuwiki acl permissions for pages onto the pads for editing the page and additionally lets you protect the pads using read and read-write passwords. Further, it integrates tightly with the dokuwiki toolbar so that most buttons will work the the etherpad lite editor as well.
16* multiple persons can edit the same page at the same time
17* almost realtime backups of edits typed
18* tight toolbar integration
19* mapping of dokuwiki permissions
20* extra password protection for read/readwrite pad access
25The user who is in (dokuwiki) "edit"-Mode can create a PAD to edit and save the content. Users in "lock"-Mode can join this PAD, but not save nor delete the PAD.
27How does it work?
32The etherpad lite gets its pads assigned to groups, group membership managed and pad passwords assigned by the dokuwiki plugin. Further, the dokuwiki plugin sets browser cookies to authorize the client to use the pad. The latter leads to some cross-domain requirements, though this could as well be fixed by adding extra code to etherpad lite.
38### etherpad lite ###
40Please refer to the etherpad lite dokumentation for its installation steps and remember to use a production-ready backend.
42To ensure pad permissions and cleanup, I recommend the following etherpad lite settings. They ensure that only users authorized by the dokuwiki plugin can edit a pad and that there are only pads created using the dokuwiki plugin.
43* "requireSession" : true,
44* "editOnly" : true,
46#### Example apache config ####
48 RewriteEngine On
49 RewriteRule ^/pad$ /pad/ [R]
50 <Proxy http://localhost:9001/>
51 Order allow,deny
52 Allow from all
54 ProxyPass /pad/ http://localhost:9001/
55 ProxyPassReverse /pad/ http://localhost:9001/
56 ProxyPreserveHost on
58### dokuwiki plugin ###
60Please refer to http://www.dokuwiki.org/plugins for additional info
61on how to install plugins in DokuWiki.
63## manual installation ##
65Use the following command to install the plugin into dokuwiki. The path name (etherpadlite in the lib/plugins folder) is important - a different name will not work!
67git clone --recursive https://github.com/michael-dev/dokuwikietherpadlite lib/plugins/etherpadlite
70## automatic installation ##
72Use https://github.com/michael-dev/dokuwikietherpadlite/blob/releases/dokuwiki-etherpadlite-current.zip to install the plugin using the dokuwiki plugin manager.
74## configuration ##
76This plugin needs configuration. See the dokuwiki configuration editor for this. More information can be found on https://www.dokuwiki.org/plugin:etherpadlite .
78### etherpad lite plugin ###
80For better integration, see the ep\_iframeinsert etherpad lite plugin.
86* Please note that password protection only works for group pads. Additionally, there is a single master group for alle wiki pages. So the temporary page id is a secret.
87* The dokuwiki plugin sets a browser cookie read by the etherpad lite (session identifier). This leads to some cross-domain restrictions.
88* Group sessions last for one week or shorter (if user uses logout button). So after one week, you'll need to reconnect.
89* Encrypted pages are not really encrypted but the etherpad-lite builtin password manager is used.
90* Pads are owned by the user who created it. Ownership cannot be transfered. If a pad exists for a page revision, there cannot be another pad for the same/a different page revision.
91* the dokuwiki integration depends on the template used and is not tested with the most recent dokuwiki default template.
95* Icons: http://openclipart.org/detail/35197/tango-accesories-text-editor-by-warszawianka (public domain)
96* Icons: http://openclipart.org/detail/74881/cerrar-by-nomade
97* Icons: http://openclipart.org/detail/22179/lock-by-nicubunu
100Copyright (C) Michael Braun <firstname.lastname@example.org>
102This program is free software; you can redistribute it and/or modify
103it under the terms of the GNU General Public License as published by
104the Free Software Foundation; version 2 of the License
106This program is distributed in the hope that it will be useful,
107but WITHOUT ANY WARRANTY; without even the implied warranty of
108MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
109GNU General Public License for more details.