BuddyPress Reactions – User Guide

BuddyPress Reactions adds Facebook-style emoji reactions to your BuddyPress community, allowing members to express their feelings about activities, comments, and forum posts with a simple click.

• 200 animated emoji reactions
• Reactions for activities, comments, and forum posts
• Real-time reaction counts
• User-friendly interface
• Mobile responsive

• WordPress 5.0 or higher
• BuddyPress 5.0 or higher
• PHP 7.2 or higher
• MySQL 5.6 or higher

1. Upload the plugin files to /wp-content/plugins/buddypress-reactions/
2. Activate the plugin through the ‘Plugins’ menu in WordPress
3. Navigate to BuddyPress → Reactions to configure settings

1. Login Required: You must be logged in to add reactions
2. Find the React Button: Look for the “React” button below activities, comments, or forum posts
3. Choose an Emoji:
   • Hover over or click the React button
   • A panel of 8 default emojis will appear
   • Click on any emoji to add your reaction
4. Instant Feedback: Your reaction is saved immediately

1. Click the React button again
2. Select a different emoji
3. Your previous reaction is automatically replaced

1. Click on the emoji you previously selected
2. Your reaction will be removed

1. Look for the reaction counts below posts
2. Hover over an emoji to see who reacted with it
3. Click on the count to see all users who reacted

Access the reactions admin area at WordPress Admin → Wbcom Designs→ BP Reactions

• View and manage reaction shortcodes
• See which emojis are assigned to each area
• Edit reaction sets for different content types

• View all 200 available emojis
• See emoji names and preview images
• All emojis are pre-installed and ready to use

Configure reactions for BuddyPress components:

Activity Stream Settings

• ✅ Enable reactions on activities
• ✅ Enable reactions on activity comments
• ✅ Hide default Like/Favorite button (optional)

Notification Settings

• ✅ Send notifications for reactions

Maintenance Tools

• 🔧 Fix Broken Emojis button – Repairs missing or broken emoji images

Configure reactions for bbPress forums:

• ✅ Enable reactions on topics
• ✅ Enable reactions on replies

The plugin comes pre-configured with optimal settings:

• Reactions enabled for all content types
• 8 popular emojis selected as defaults
• Notifications enabled
• Animations enabled

Each content type can have different emoji selections:

1. Activity Reactions: Default set of 8 emojis
2. Comment Reactions: Same as activities by default
3. Forum Reactions: Uses the same emoji set

Default emojis include:

• 👍 Thumbs Up
• ❤️ Sparkling Heart
• 🤗 Hugging
• 😂 Joy
• 😏 Hushed
• 😡 Pouting
• 😢 Crying
• 😇 Angel

Three widgets are available:

1. Reaction Stats Widget – Shows reaction statistics
2. Modern Reactions Widget – Modern UI for reactions
3. Last 3 Months Stats – Recent reaction trends

Solution:

1. Go to WordPress Admin → Wbcom Designs → BP Integration
2. Find the “Maintenance” section
3. Click “Fix Emojis” button
4. Wait for the process to complete

Check:

• You are logged in (reactions require authentication)
• Reactions are enabled in settings
• JavaScript is not blocked in your browser
• Clear browser cache and reload

Possible Causes:

• Not logged in (login required)
• JavaScript errors (check browser console)
• Theme compatibility issues

Solution: This has been fixed in the latest version. Clear your cache.

1. The plugin uses caching for better performance
2. Emoji files are optimized SVG format
3. JavaScript loads only where needed

Q: How many emojis are available?

A: The plugin includes 200 different emojis, all with animations.

Q: Can users add custom emojis?

A: Currently, the plugin uses a fixed set of 200 pre-installed emojis.

Q: Do reactions work on mobile devices?

A: Yes, the interface is fully responsive and touch-friendly.

Q: Can I limit who can add reactions?

A: Reactions require users to be logged in. You can use WordPress capabilities to further restrict access.

Q: Where are reactions stored?

A: Reactions are stored in custom database tables for optimal performance.

Q: Will reactions slow down my site?

A: No, the plugin is optimized with caching and efficient queries.

Q: Can I export reaction data?

A: Reaction data is stored in the database and can be exported with standard WordPress/database tools.

Q: Are reactions GDPR compliant?

A: Yes, reaction data is tied to user accounts and can be deleted with user data.

Q: Can I change the emoji names?

A: Emoji names are standardized and synchronized with the database.

Q: Can I change which emojis appear?

A: Yes, through the admin interface you can select different emoji sets for each content type.

Q: Can I style the reaction buttons?

A: Yes, the plugin includes CSS classes that can be customized in your theme.

For additional help:

1. Check the plugin documentation
2. Visit the support forum
3. Contact support at support@wbcomdesigns.com