Skip to content
A reactions plugin for Discourse
Ruby JavaScript CSS HTML
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
assets fix: remove the z-index on post Sep 21, 2019
config Translate reacted with sentence May 18, 2019
screenshots Update README Jul 6, 2016
spec Initial commit Nov 22, 2015
LICENSE.md Initial commit Nov 22, 2015
README.md Allow disabling categories via site setting Jan 17, 2018
plugin.rb

README.md

Retort - A Reaction Plugin for Discourse

Retort allows you and your users to add slack-style reactions to your discourse posts.

Check out a quick gif of it in action here!

Installation

You're done!

Limiting the possible emoji set

Some communities will want to limit the possible reactions to just a few, rather than all possible emojis. Retort now supports this!

limited reactions

In order to use a limited emoji set, simply visit admin/site_settings/category/plugins, and check the box which says 'Constrain the list of reactions to the list specified below'.

admin_panel

Then, enter the list of emojis you'd like to support, delimited by the '|' character. (So, for example, if you only wanted to support thumbs up / thumbs down reactions, you'd put in +1|-1)

Feel free to style elements underneath the .retort-picker class in Admin > Customize > HTML/CSS, if you need further customizations like emoji size, spacing, etc.

Limiting the number of reactions per post

There's an additional site setting, 'retort allow multiple reactions', which determines whether users can react to a single post multiple times or not. (It is enabled by default). If you only want users to be able to create one reaction per post (if you're using Retort as a voting system, for example), set this option to false.

Disabling retort for particular categories

The 'retort disabled categories' site setting allows disabling particular reacting in particular categories by name. These category names are case-insensitive.

For example, entering staff|announcements into this field will disallow all users from reacting to topics in the categories name 'Staff' or 'Announcements'.

Contributing

Pull requests welcome! To contribute:

  • [Fork it] (../../fork )
  • Create your feature branch (git checkout -b your-new-feature)
  • Commit your changes (git commit -am 'Add some feature)
  • Push to the branch (git push origin your-new-feature)
  • Create a new Pull Request
You can’t perform that action at this time.