README.md

Discourse Slack Plugin

ATTENTION: Consider using the offical discourse Slack plugin instead:

• https://meta.discourse.org/t/the-official-discourse-slack-plugin/51412
• https://github.com/discourse/discourse-slack-official

This discourse plugin sends a notification to a Slack channel for each newly created topic.

See: https://meta.discourse.org/t/slack-notification-plugin/32200/4

Tested Discourse Versions

• 1.3.x

Installation

Please read the offical discourse plugin installation documentation.

If you use the (officially recommended) docker setup you can just have to add git clone https://github.com/bernd/discourse-slack-plugin.git to the list of after_code executions in your /var/discourse/containers/app.yml file. (filename might be different in your setup!)

hooks:
  after_code:
    - exec:
        cd: $home/plugins
        cmd:
          - mkdir -p plugins
          - git clone https://github.com/discourse/docker_manager.git
          - git clone https://github.com/bernd/discourse-slack-plugin.git

After adjusting the config file run ./launcher rebuild app in /var/discourse to stop/rebuild/start the discourse instance.

Configuration

You need to configure an incoming-webhook for your team to use this plugin. The "Webhook URL" is needed for the plugin configuration.

Go to Admin/Settings/Slack, enable the plugin and make sure to add the "Webhook URL" to the slack url field.

Example:

Slack Example Notification

This is how it looks like in slack. (with a custom emoji for the discourse logo)

Contributions

All contributions are welcome!