diff options
Diffstat (limited to 'doc/jabber.markdown')
-rw-r--r-- | doc/jabber.markdown | 34 |
1 files changed, 34 insertions, 0 deletions
diff --git a/doc/jabber.markdown b/doc/jabber.markdown new file mode 100644 index 00000000..fe365168 --- /dev/null +++ b/doc/jabber.markdown @@ -0,0 +1,34 @@ +Jabber/XMPP integration +======================= + +You can send notifications to a Jabber room for all projects or only for specific projects. + +- To send notifications for all projects, go to **Settings > Integrations > Jabber** +- To send notifications for only some projects, go to **Project settings > Integrations > Jabber** + +Each project can send notifications to a separate room. + +## Example of notification + +Here an example with the Jabber client Adium: + +![Jabber notification](http://kanboard.net/screenshots/documentation/jabber-notification.png) + +## Configuration + +![Jabber settings](http://kanboard.net/screenshots/documentation/jabber-settings.png) + +1. Go to **Settings > Integrations > Jabber** or **Project settings > Integrations > Jabber** +2. **XMPP server address**: URL of the XMPP server, example: **tcp://172.28.128.3:5222** +3. **Jabber domain**: The **"to"** attribute of the XMPP protocol, example: **example.com** +4. **Username**: The Jabber username used by Kanboard, example: **kanboard** +5. **Password**: The Jabber password +6. **Jabber nickname**: The nickname used to connect to the room +7. **Multi-user chat room**: The address of the room, example: **demo@conference.example.com** + +Now, Kanboard events will be sent to the Jabber conference room. + +## Troubleshooting + +- Enable the debug mode +- All connection errors with the XMPP server are recorded in the log files `data/debug.log` or syslog |