Skip to main content

# Setup

What's Your Reaction allows users to set up their own reactions and tag posts with them.

## Create a reaction

To create your own reactions, please:

1. Go to the WordPress Admin › Posts panel
2. Go to the Reactions section
3. Set up the name for your new reaction
4. Choose an icon from available sets or upload your own
5. Slug and description fields are optional
6. Put a number inside Order field to affect the order in which reaction will be displayed next to others
7. Press Add New Reaction button

## Assign reaction to a post (automatically)

A post is tagged with a reaction when 3 different users vote for that reaction. Only then the reaction is assigned to the post and the post is displayed on the reaction archive page.

## Assign reaction to a post (manually)

To tag a post with a reaction, please:

1. In the post editor find the Reactions section
2. Type in the name of reaction and press add

Reactions are visible in the site's header, on a single post and as entry flags in post archives.

## Hide reactions in the site header

In order to hide reactions in the site header, please:

1. Go to the WordPress Admin › Appearance › Customize panel
2. Go to the What's Your Reaction Plugin › General section
3. Change the Show reactions in header option to "no".

## Hide reaction flags on a single post

In order to hide reactions in the page header, please:

1. Go to the WordPress Admin › Appearance › Customize panel
2. Go to the What's Your Reaction Plugin › General section
3. Change the Show entry reactions on single post option to "no".

## Hide reaction flags on in collections

In order to hide reactions in the page header, please:

1. Go to the WordPress Admin › Appearance › Customize panel
2. Go to the What's Your Reaction Plugin › General section
3. Change the Show entry reactions in collections option to "no".

## Custom icons and SVG support

To use a custom icon, you will have to first upload it to your Media Library. If your icon is a SVG image, WordPress won't allow you to upload it. The reason SVG images are not allowed is that there are security concerns to be addressed. SVG is an XML file, which by itself opens it up to different vulnerabilities of which normal image formats are not affected. Best and, what's more important, safe way to allow SVG uploads is to use the Safe SVG plugin. The theme is fully compatible with it, so when you enable the Safe SVG plugin it will take full control over uploaded SVGs, the same protect your site against SVG/XML vulnerabilities.

More detailed info about SVG security concerns you will find in the How to Safely Enable WordPress SVG Support article.