mibew_slack/README.md

Mibew Slack plugin

Provides Slack notifications when initiate a chat

Installation

1. Get the archive with the plugin sources. At the moment the only option is to build the plugin from sources or grab it from the zip file.

2. Untar/unzip the plugin's archive.

3. Put files of the plugins to the <Mibew root>/plugins folder.

4. Obtain a webhook key from Slack:

   a. Go to Slack.com , open your app directory, find and enter Incoming WebHooks app, click on Add Configuration

   b. Click on App Configuration. Choose the Channel it should post to, click on Add Incoming Webhook Integration

   c. Copy the Webhook URL

5. Add plugins config to plugins structure like below.

   plugins:
       "Mibew:Slack": # Plugin's configurations are described below
           username: "Username you will post as"
           channel: "Channel to post in"
           slack_url: "Webhook URL from Setup Instructions in Slack"
   
   

Plugin's configurations

The plugin can be configured with values in "<Mibew root>/configs/config.yml" file.

Build from sources

There are several actions one should do before use the latest version of the plugin from the repository:

1. Obtain a copy of the repository using git clone, download button, or another way.
2. Install node.js and npm.
3. Install Gulp.
4. Install npm dependencies using npm install.
5. Run Gulp to build the sources using gulp default.

Finally .tar.gz and .zip archives of the ready-to-use Plugin will be available in release directory.

License

Apache License 2.0