Discourse Response Bot

This is a Discourse plugin. It works as a bot automatically replying newly created topics within a Discourse forum with a default wiki post. This allows users to collaborate and construct a single answer for topics created.

Install

Docker install

As seen in a how-to on meta.discourse.org, add this repository's git clone url to your container's app.yml file, at the bottom of the cmd section:

hooks:
  after_code:
    - exec:
        cd: $home/plugins
        cmd:
          - mkdir -p plugins
          - git clone https://github.com/bolariin/discourse-response-bot.git

rebuild your container:

cd /var/discourse
git pull
./launcher rebuild app

Non-docker install

• Run bundle exec rake plugin:install repo=https://github.com/bolariin/discourse-response-bot.git in your discourse directory
• In development mode, run bundle exec rake assets:clean
• In production, recompile your assets: bundle exec rake assets:precompile
• Restart Discourse

Local Development Install

• Clone the Discourse Response Bot Repo in a new local folder.
• Separately clone Discourse Forum into another local folder and install Discourse.
• In your terminal, go into Discourse folder navigate into the plugins folder. Example cd ~/code/discourse/plugins
• Create a symlink for the downloaded response bot plugin in this folder (plugins folder) by typing the following into your terminal

ln -s ~/path_of_cloned_discourse_response_bot_plugin .
For example: ln -s ~/discourse-response-bot .

• You can now make changes in your locally held Discourse Response Bot folder and see the effect of your changes when your run rails s in your locally held Discourse Forum files.

Getting Started

• By default, all settings have been enabled

• The details of the response bot such as username, name, trust level and more can be changed in the admin panel.
  To change response bot details

  • Open up the admin panel
  • Select Users (it is the option beside Settings)
  • You should find "responseBot" in the table under Active,
    • if "responseBot" is not under Active, click New (the option beside Active)
    • Check the table underneath New
  • Click on "responseBot", now you have full control to change any response bot details.
    PS: Changes to the username and name will reflect in previous posts made by response bot.

Features

• If you wish to change the default response message of reponse bot, you can achieve this.

  • In the plugin settings for response bot

• If you wish to enable response by the response bot on select categories, you can acheive this.

  • You can achieve this by unselecting "Allow response bot to reply all topics"

  • In the category settings of the select category, enable "Allow response bot to reply topics in this category"

  • Now, the response bot will respond new topics in that category.

• If you wish to disable response by the response bot on select categories, you can also acheive this.

  • You can achieve this by selecting "Allow response bot to reply all topics"

  • In the category settings of the select category, enable "Disallow response bot from replying topics in this category"

  • Now, the response bot will not respond new topics in that category.

Suggestions/Issues

Feel free to report issues, ask questions or suggest improvements/fixes on Discourse Meta.

License

MIT