xref: /plugin/matrixnotifier/README.md (revision c876dc2c5d6d3c615d76c5cdd20c6ba3bfe75799)
187fd18beSWilhelm von Thiele# DokuWiki Matrix Notifier
2dd7d8b2fSWilhelm von ThieleNotify DocuWiki page events via [Matrix](https://matrix.org/)
387fd18beSWilhelm von Thiele
4da035f83SWilhelm von Thiele## Example
5da035f83SWilhelm von Thiele
6*c876dc2cSWilhelm von Thiele<img width="780" height="259" src="https://raw.githubusercontent.com/TurtleWilly/dokuwiki-matrix-notifier/master/documentation/example.png">
7da035f83SWilhelm von Thiele
887fd18beSWilhelm von Thiele## Installation
987fd18beSWilhelm von Thiele
10c96cab09SWilhelm von ThieleDrop the `matrixnotifier` directory under `lib/plugins/` in the DocuWiki installation. Alternatively zip the `matrixnotifier` directory and then use DocuWiki's *Extension Manager* (Admin menu) to do a manual installation.
1187fd18beSWilhelm von Thiele
1287fd18beSWilhelm von Thiele## Configuration
1387fd18beSWilhelm von Thiele
14c96cab09SWilhelm von ThieleThe plugin is configured via DocuWiki's *Configuration Settings* (Admin menu).
1587fd18beSWilhelm von Thiele
1687fd18beSWilhelm von Thiele### Required Settings
1787fd18beSWilhelm von Thiele
186a06320aSWilhelm von ThieleOption | Description
196a06320aSWilhelm von Thiele------ | -----------
206a06320aSWilhelm von Thielehomeserver | the Matrix home server to use, e.g. https://matrix.example.com/
216a06320aSWilhelm von Thieleaccesstoken | the access token for the Matrix account to use
226a06320aSWilhelm von Thieleroom | the internal ID for the Matrix room where to post the notifications
2387fd18beSWilhelm von Thiele
246a06320aSWilhelm von Thiele> With the standard Matrix client **Element** the accesss token can be found in the user account settings under `Help & About > Advanced > Access Token`. The required internal room ID can be found in the options for the room under `Advanced > Room Information`.
2587fd18beSWilhelm von Thiele
2687fd18beSWilhelm von Thiele## Credits
2787fd18beSWilhelm von Thiele
2887fd18beSWilhelm von ThieleWilhelm/ JPTV.club
2987fd18beSWilhelm von Thiele
30dd7d8b2fSWilhelm von ThieleThis project was loosely forked from the *DokuWiki Discord Notifier* (https://github.com/zteeed/dokuwiki-discord-notifier).
31