Discourse Reactions

[Discourse]

	Summary	Discourse Reactions allows users to React to a post from a choice of emojis, rather than only the Like heart. The available emoji selection can be set from the admin settings.
	Repository Link	https://github.com/discourse/discourse-reactions
	Install Guide	How to install plugins in Discourse

As this is an official plugin maintained by the Discourse team, support, bug, ux, and feature requests can be made in the respective categories here on Meta, and tagged with the appropriate plugin tag. Click on a link below to get one started.

 Support  Bug  UX  Feature

Bored of likes in discourse? Here’s something you will definitely love.

Overview

Discourse-reactions is a plugin that allows user to add their reactions to the post. This plugin can engage more audiences to the post. Users who may not have previously wanted to Like your content are now able to send more specific signals about how your content makes them feel. Users who may not have wanted to use their phones to post can now use them to “react” much easier.

Reactions can be different on each website as we have an amazing feature where site admin can set their list of emojis which can be used as reactions.

To customize the reactions use the site setting discourse_reactions_enabled_reactions and define emojis you want as reactions separated by | eg: open_mouth|cry|angry

This plugin will work as an add-on to the likes feature, anytime you want to remove the plugin, all likes will be preserved.

Configure

You can configure these Site Settings:

• discourse_reactions_enabled To enable the plugin
• discourse_reactions_enabled_reactions To define the list of enabled reactions, any emoji is allowed here. default: laughing|open_mouth|cry|angry|thumbsup|thumbsdown
• discourse_reactions_like_icon To replace the like icon.
• discourse_reactions_reaction_for_like To define the name of like reaction.

Creating a reaction

The reaction can be created either by clicking the like icon OR by hovering and selecting reaction from the reaction picker.

Note:

• In Mobile to open the reaction-panel long press on like icon.

See who reacted?

On the left side of the post, there will be a list of reactions, by clicking on it, there will be a modal displayed with the list of reactions.

If there are only likes in the post, a list of reactions will not be available but there will be a like-count besides the like button. clicking on it will display the same modal.

Don’t want to see this whole modal? Just hover on the reaction-emoji in the list to see the recently reacted users (Available Only on the desktop site).

See Your reactions?

In the user page activity, there is an extra Reactions tab where you will find all reactions you made.

See who reacted to your post?

In the user page notifications, there is an extra Reactions tab where you will find all reactions made to your posts.

Badge

First Reaction Badge is granted to the user when they make their first reaction to a post.

Contributors

@Ahmed_Gagan

@joffreyjaffeux
@kris.kotlarek
@Roman_Rizzi

Special Thanks

Special thanks to @joffreyjaffeux for being such a nice mentor and for being super helpful in everything and @team for helping us to make the plugin works perfect by finding bugs as much as possible.

Last edited by @JammyDodger 2024-06-18T14:22:05Z

Check document

Perform check on document:

[hazenbiz (Hazen Ellwood)]

about.json error while trying to install

[Moin]

This is a plugin. You cannot install plugins like themes and theme components.

@Discourse

	Install Guide	How to install plugins in Discourse

[haydenjames]

Is this compatible with the Gamification plugin?

[NateDhaliwal]

Of course. Meta has both, and they work fine. Are they not in your forum?

[Lilly]

Hi @haydenjames - i know your forum isn’t using either of these, but yes they are compatible. here is some info about reaction as likes, which affects gamification scoring too.

Changes to which reactions are counted as likes

Announcement I would like to announce that we are going to start rolling out the discourse_reactions_like_sync_enabled setting to all of our hosted sites, setting it to true, and setting it to default true for new sites. What this means is that historical reactions will have a Like record created for them. On some sites that haven’t used reactions this may be a very small amount, on other sites this may be to the tune of tens of thousands of records. This will influence the Top and Ho…

[ddventures (Dexter)]

For some odd reason, I have the plugin Discourse Reactions installed and enabled but my posts don’t seem to be showing the heart.

Is there another option to enable it?

[NateDhaliwal]

What happens if you inspect the page there? Perhaps the heart element is there, just hidden or a problem with Font Awesome?

[Firepup650 (Firepup Sixfifty)]

You won’t see the like icon on your own posts, until someone else reacts to them.