122 lines
5.1 KiB
Markdown
122 lines
5.1 KiB
Markdown
Messenger plugin for Redmine
|
|
============================
|
|
|
|
This plugin posts updates to issues in your Redmine installation to [Slack](https://slack.com/), [Rocket.Chat](https://rocket.chat/), [Discord](https://discordapp.com/) or [Mattermost](https://about.mattermost.com/) channel.
|
|
|
|
[](https://www.redmine.org/plugins/redmine_messenger) [](https://travis-ci.org/AlphaNodes/redmine_messenger)  
|
|
|
|
Features
|
|
--------
|
|
|
|
* Post information to messenger channel
|
|
* post issue updates
|
|
* post private issue updates
|
|
* display watchers
|
|
* convert username to mentions
|
|
* post wiki updates
|
|
* post db entry (if redmine_db is installed) updates
|
|
* post password (if redmine_passwords is installed) updates
|
|
* post contact (if redmine_contacts is installed) updates
|
|
* Post information directly to users to be notified (users names should be the same in Redmine and chat). Tested with Rocket.Chat
|
|
* overwrite messenger settings at project level
|
|
* parent project support (inherit messenger settings from parent project)
|
|
* multiple channel support (define one or more channels to deliver note)
|
|
|
|
Screenshot
|
|
----------
|
|
|
|
Mattermost output:
|
|
|
|
|
|
|
|
Redmine configuration:
|
|
|
|
|
|
|
|
* **Convert names to mentions:** Automatically converts Redmine mentions into Slack mentions so a user is notified through Slack when mentioned in a Redmine note. Depends on Redmine Mentions plugin.
|
|
|
|
* **Display watchers:** Issue watchers are included in notifications.
|
|
|
|
* **Post issue updates:** All newly created notes on an issue generate a notification (does not include private issues).
|
|
|
|
* **Description in new issue:** Include the text description of a new issue in the notification.
|
|
|
|
* **Description in update issue:** Include the text encompassed in a note upon updating the issue in the notification.
|
|
|
|
* **Post updates for private issue:** Same as *Post issue updates* but for private issues.
|
|
|
|
* **Post private notes:** Same as *Description in update issue* but for private issues.
|
|
|
|
* **Post wiki updates:** Generates a notification when a projects Wiki is updated.
|
|
|
|
Prepare your messenger service
|
|
------------------------------
|
|
|
|
### Slack
|
|
|
|
Go to Slack documentation [Incoming Webhooks](https://api.slack.com/incoming-webhooks) for more information to set up Incoming WebHook
|
|
|
|
### Mattermost
|
|
|
|
Go to Mattermost documentation [Incoming Webhooks](https://docs.mattermost.com/developer/webhooks-incoming.html) for more information to set up Incoming WebHook
|
|
|
|
### Discord
|
|
|
|
Go to Discord documentation [Intro to Webhooks ](https://support.discordapp.com/hc/en-us/articles/228383668) for more information to set up Incoming WebHook
|
|
You have to add /slack after your webhook url.
|
|
|
|
### Rocket.Chat
|
|
|
|
Go to Rocket.Chat documentation [Incoming WebHook Scripting](https://rocket.chat/docs/administrator-guides/integrations/) for more information to set up Incoming WebHook
|
|
|
|
|
|
Requirements
|
|
------------
|
|
|
|
* Redmine version >= 4.0.0
|
|
* Ruby version >= 2.4.0
|
|
|
|
If you want to use it with Redmine 3.x, use git tag 1.0.5
|
|
|
|
Installation
|
|
------------
|
|
|
|
Install ``redmine_messenger`` plugin for `Redmine`
|
|
|
|
cd $REDMINE_ROOT
|
|
git clone https://github.com/AlphaNodes/redmine_messenger.git plugins/redmine_messenger
|
|
bundle update
|
|
bundle exec rake redmine:plugins:migrate RAILS_ENV=production
|
|
|
|
Make sure that the directory is named `redmine_messenger` (you cannot use another name for it)!
|
|
Restart Redmine (application server) and you should see the plugin show up in the Plugins page.
|
|
Under the configuration options, set the Messenger API URL to the URL for an
|
|
Incoming WebHook integration in your Messenger account and also set the Messenger
|
|
Channel to the channel's handle (be careful, this is not the channel's display name
|
|
visible to users, you can find each channel's handle by navigating inside the channel
|
|
and clicking the down-arrow and selecting view info).
|
|
|
|
|
|
Uninstall
|
|
---------
|
|
|
|
Uninstall ``redmine_messenger``
|
|
|
|
cd $REDMINE_ROOT
|
|
bundle exec rake redmine:plugins:migrate NAME=redmine_messenger VERSION=0 RAILS_ENV=production
|
|
rm -rf plugins/redmine_messenger
|
|
|
|
Restart Redmine (application server)
|
|
|
|
|
|
Credits
|
|
-------
|
|
|
|
The source code is forked from
|
|
|
|
- [redmine_rocketchat](https://github.com/phlegx/redmine_rocketchat)
|
|
- [redmine_mattermost](https://github.com/altsol/redmine_mattermost)
|
|
- [redmine-slack](https://github.com/sciyoshi/redmine-slack)
|
|
|
|
Special thanks to the original author and contributors for making this awesome hook for Redmine. This fork is just refactored to use Messenger-namespaced configuration options in order to use all hooks for Rocket.Chat, Mattermost AND Slack in a Redmine installation.
|