Jabber plugin for Kanboard
Clone or download
Latest commit 554d229 Jun 16, 2018

README.md

Jabber/XMPP plugin for Kanboard

Build Status

Receive Kanboard notifications on Jabber.

Author

  • Frederic Guillot
  • License MIT

Requirements

  • Kanboard >= 1.0.37
  • XMPP server

Installation

You have the choice between 3 methods:

  1. Install the plugin from the Kanboard plugin manager in one click
  2. Download the zip file and decompress everything under the directory plugins/Jabber
  3. Clone this repository into the folder plugins/Jabber

Note: Plugin folder is case-sensitive.

Configuration

XMPP Server Settings

Go to Settings > Integrations > Jabber and fill the form:

  • XMPP server address: Address of your Jabber server (tcp://jabber.example.com:5222)
  • Jabber domain: Jabber domain
  • Username: Kanboard username to connect to your Jabber server
  • Password: Kanboard password to connect to your Jabber server
  • Jabber nickname for Kanboard: nickname used by Kanboard

Receive individual user notifications

  • Go to your user profile then choose Integrations > Jabber
  • Enter your Jabber Id (JID), by example me@example.com
  • Then enable Jabber notifications in your profile: Notifications > Select Jabber

Receive project notifications to a room

Troubleshooting

  • Enable the debug mode
  • All connection errors with the XMPP server are recorded in the log files data/debug.log or syslog

Changes

Version 1.0.8

  • Update XMPP library
  • Update Documentation links

Version 1.0.7

  • Fix bug concerning task overdue events