Widgets

Widgets

BuddyPress Reactions includes three sidebar widgets that display reaction statistics. Add them through Appearance > Widgets or the Customizer.

Available widgets

(BuddyPress) Reactions List

Displays the most-used reactions over a chosen time period in a grid or list layout.

Settings:

Setting	Description
Title	Widget heading shown to visitors
Time period	Filter reactions to: all time, last 7 days, last 30 days, last week, or last month
Max reactions	How many top reactions to show (default 8)
Layout	Grid or list display
Show count	Whether to show the number next to each emoji

(BuddyPress) Reactions - Modern

A lighter version of the stats widget with a more compact presentation. Uses the same underlying data.

Settings:

Setting	Description
Title	Widget heading
Layout	Grid or list
Show count	Show the number next to each emoji
Show names	Show the emoji label text
Limit	Number of reactions to display
Time period	Today, last 7 days, last 30 days, last 3 months, or all time
Show total	Display the total reaction count above the list

(BuddyPress) Reactions Stats

A statistics-focused widget that shows reaction data with chart visualizations.

Widget data and caching

Widget data is cached using WordPress object cache with a one-hour expiry. On sites without a persistent object cache, the query runs on every page load. With a persistent cache (Redis, Memcached), results are served from cache between expiries.

The cache is keyed by widget settings, so different instances of the same widget with different time periods each have independent caches.

Placing widgets

1. Go to Appearance > Widgets.
2. Find the widget by name (search for “Reactions”).
3. Drag it into the sidebar or widget area where you want it.
4. Configure the settings and click Save.

In block-based themes that use the Site Editor instead of the classic Widgets screen, add the widget as a Legacy Widget block.

Related pages

• Reactions Log — view raw reaction data
• Configure Reactions