Documentation/  

Reactions

Editing Reactions

To edit a reaction, click on one of the default reactions in the list. From there, these options are listed which can be edited by an administrator.

  • Add Reaction - When this is clicked, you can create a new reaction.
  • Import - When this is clicked, you can import reactions from another forum.
  • Export - When this is clicked, you can export reactions from your forum which can be used on another forum which use this plugin.
General

Title - The title of the reaction or name of the reaction.

Display Order - Enter a number based on order of these reactions to be seen. (ie: 1,2,3,4,5,etc)

Reaction Type - This will change what type reaction it will be. Rather it be a positive, neutral, or negative type.

Enabled - This setting will allow you to choose whether this is shown to users or not.

Random Reaction - This will choose a random reaction to be used.

Like Wrapper - The reaction will be stored within the default XenForo like handler.

Default Reaction - This will allow you to set the default reaction which is always showed no matter what reaction is enabled or disabled.

Styling

Styling Type - This setting will allow you to choose how the reaction will be styled and displayed. These settings include:

  • Image
  • Text / Emoji
  • CSS Class
  • HTML/CSS

Image Replacement URL - This is where you can input an image path which will be used in case the options above can’t be used.

2x Image Replacement URL - This setting is where you can input an image path to an 2x based image which will be automatically displayed instead of the image above on devices capable of displaying a higher pixel resolution.

Image Type - This setting allows you to set the image type which is used with the necessary styling options included.

These settings include:

  • Normal Image
  • Sprite Image

Image Dimensions - This setting allows you to set the image dimensions for this reactions image.

Style Dimensions - This setting allows you to use the width and height defined within the style properties for whichever one you are currently using.

Criteria

Content Handlers - With this setting you can choose which content this reaction can be used on.

These handlers include:

  • Conversation Messages
  • Profile Posts
  • Posts
  • Profile Post Comments

Allowed Forums - This setting allows you to select whichever forums you want this reaction to work on.

Disabled Forums - This setting allows you to select whichever forums you want this reaction not to work on.

User Criteria

Privileges and status - This setting allows you to choose different type of states. These include if a user is a:

  • Guest
  • Logged In
  • Moderator
  • Administrator
  • Banned
  • Birthday is Today
  • Valid
  • Awaiting email confirmation
  • Awaiting email confirmation (from edit)
  • Email invalid (bounced)
  • Awaiting Approval
  • Rejected
  • Disabled

Connected Accounts - This setting allows you to choose what connected accounts can use this reaction. These include if the user is associated with any of the selected connected account providers:

  • Facebook
  • Google
  • Github
  • LinkedIn
  • Microsoft
  • Yahoo

User groups - This setting allows you to choose what user groups can use this reaction. These include if the user is a member of any of the selected user groups:

  • Administrative
  • Moderator
  • Registered
  • Unregistered / Unconfirmed

User groups - This setting allows you to choose what user groups can use this reaction. These include if the user is NOT a member of any of the selected user groups:

  • Administrative
  • Moderator
  • Registered
  • Unregistered / Unconfirmed

Content and Achievements

  • User has posted at least X messages - This setting allows you to choose how many messages a user has to have posted. This can be edited by clicking the '+' or '-'.
  • User has posted no more than X messages - This setting allows you to choose how many messages a user has to have no more than the amount posted. This can be edited by clicking the '+' or '-'.
  • User has received at least X likes - This setting allows you to choose how many likes a user has to have. This can be edited by clicking the '+' or '-'.
  • User likes to messages ratio is at least - This setting allows you to choose how many messages a user has liked at least. This can be edited by clicking the '+' or '-'.
  • User has at last X trophy points - This setting allows you to choose how many trophy points a user has to have at least. This can be edited by clicking the '+' or '-'.
  • User has been registered for at least X days - This setting allows you to choose how many days a user has be registered on your forum. This can be edited by clicking the '+' or '-'.
  • User has not visited for at least X days - This setting allows you to choose how many days a user has not visited on your forum. This can be edited by clicking the '+' or '-'.
User profile and Options

User is browsing with the following language - This setting allows you to choose what language a user is browsing with.

Avatar - You can choose whether you want a user to have a avatar or not have an avatar.

High resolution avatar - You can choose whether you want a user to have a high resolution avatar or not.

Two-step authentication - You can choose whether you want a user to have two-step authentication enabled or disabled.

Specific Users

User name is - This setting allows you to choose specific users, be sure when adding other users that you use a comma.

User name contains With this setting, you can enter one or more snippets separate by commas and users who names contain any of the snippets which match the criteria.

User’s email address contains - This setting allows you to enter one or more snippets separated by commas and users email addresses that contain any of the snippets which match the criteria.

User field criteria

Contact Details - With this setting you can choose which user field criteria to based on Skype, Facebook, or Twitter. This is based on the text being entered in the field boxes along with the setting “User value contains text”.

Options

Send Alerts - This setting will allow users who receive a reaction will also get an alert showing them where it was given and who gave it.

Publish to Newsfeed - This setting when enabled a newsfeed entry will be made about a reaction being given.

Prevent unreact - When enabled the reaction cannot be removed from any content. Please note that if the user has the permission to unreact to all reactions this will not affect them.

Max per day per user - With this setting you can Choose how many times this reaction can be used in a single day per user. Please note that this value will not overwrite the max number set per user group.

Reaction Types

Add reaction type - This setting allows you to create a new reaction type.

Reaction type ID - This is the reaction type that will uniquely identify it.

Title - This is where you can add a title or name for the reaction type.

Display Order - Enter a number based on order of these reactions to be seen. (ie: 1,2,3,4,5,etc)

Color - This allows you to select a color which is used for that reaction type.

Reaction User Group Permissions

Such user group permissions can be set to use for non-moderation based users:

Reaction Tools

Convert likes to reactions - This tool will convert XenForo likes into your default "Like handler" reaction for supported content likes.

Convert reactions to likes - This tool will convert any 'Like handler' reactions into default XenForo likes. Use this if you migrate from a system that didn't have their ratings stored as likes.

Rebuild reacts counted status - This tool will allow you to rebuild any react counts which can relate to profile posts, conversation messages, profile posts comments, resource updates, thread posts, and XenForo's media manager.

Rebuild content react counts - This tool will allow you to rebuild any content react counts which can relate to profile posts, conversation messages, profile posts comments, resource updates, thread posts, and XenForo's media manager.

Rebuild user reaction total - This tool will allow you to rebuild the number of reactions any user has used all over the forum all together in total.

Rebuild user reaction count - This tool will allow you to rebuild the number of reactions if the count of reactions is incorrect.

Rebuild add-on columns - This tool will allow you to rebuild add-on columns if they are installed installed after reactions is installed.

  • Can react
  • Can remove own reacts
  • Can view reacts list
  • Maximum number of reacts per content
  • Maximum number of reactions per day

Such user group permissions can be set to use for moderation based users:

  • Can remove all reacts
Style Properties

Show Reaction Titles - When hovering over the reactions, it shows the title/name of each reaction.

Reaction image dimensions - This allows you to change the image dimensions, this will only be used for reactions that have been enabled to use the style properties.

Max reactions before minimal display - This setting allows you to set the maximum amount of existing reactions that will be shown before they are turned into a minimal display.

Reactions divider text - This setting allows you to set a character or word that is between the reaction and its count when viewing the content list. Leave blank for no divider.

Enable total reactions received in postbit - This setting will show the overall reactions that a user has received in a condensed format.

Location to display reaction details in postbit - This setting allows you to change the display reaction details in the postbit. These locations include bottom and top.

Location to display reaction bar in content - Choose where you want the reaction bar to display in the content. Currently only utilized for posts.

Reaction postbit type - This setting allows you to choose if the types of reactions are shown by bar or by text.

Animation Type - This will enable various animations when reacting to content.

Trigger Type - The type of trigger that should be used for reactions, these include image path, glyph class, or template.

Trigger Value - The path to the image, glyph class to be used or the name of the template.

Such settings below will allow you to change the text size, color, custom CSS, and more:

Always Show Secondary Trigger - This setting allows you to show the secondary trigger at all times when ticked off.

  • Reactions Bar Style
  • Trigger Style
  • Trigger Image Styling
  • List Item Style
  • ListItem Right Style
  • Modal Style
  • Modal Wrapper Style
Desktop

Slide-Up Animation:

Slide-Out Animation:

Modal Animation:

Mobile

Slide-Up Animation:

Slide-Out Animation:

Modal Animation:

Add-on Options

With reaction handlers, you are able to globaly toggle which conversation/comment based handlers use Reactions. These handlers include:

  • Conversation messages
  • Posts
  • Profile Posts
  • Profile Post Comments
Copyright © 2024 Audentio, LLC. All Rights Reserved.