discourse-slack-plugin icon indicating copy to clipboard operation
discourse-slack-plugin copied to clipboard

Send notifications to slack for new topics in discourse

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:

Discourse slack configuration

Slack Example Notification

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

Discourse slack example notification

Contributions

All contributions are welcome!