Reactions

Universal reactions for MODX Revolution 3. From a simple like/dislike pair to a GitHub-style set — on a resource, miniShop3 product, or any other object.

The component is headless: no manager UI. You configure it via system settings, REST API, and CLI.

Source: Ibochkarev/Reactions (MIT).

Features

• Three built-in sets: updown, github, full (24 types)
• Compact picker for github / full (layout=auto): chips + + button. layout=bar for the full strip
• Custom types and sets via CLI or admin API
• Reactions on any object (class / class_key, DB field object_class)
• Click again to remove. In an exclusive set another reaction replaces the previous one
• Identity strategies: auth_only, ip, ip_cookie, session
• Tops for day / week / month / year / all time. Trending with a Reddit-style score
• Rate limit, bot blocking, CSRF, Origin check
• MODX events, webhooks (Telegram, Discord, Slack), author notifications

Requirements

Requirement	Version
MODX Revolution	3.0+
PHP	8.2–8.4
Database	MySQL / MariaDB (InnoDB)

Installation

1. Install the Reactions transport package via Package Management.
2. The package creates tables, presets (updown, github, full), snippets, chunks, and system settings.
3. Manage → Clear Cache.

Build from source (needs Node.js and npm):

composer install
php _build/build.php

build.php builds the widget from frontend/ into assets/components/reactions/js/web/.

Short path

1. Load CSS/JS and call the Reactions snippet — Quick start.
2. Change the set or identity strategy if needed — System settings.
3. For the storefront: miniShop3, pdoTools, SEO.

Built-in sets

Key	Reactions	Mode
updown	👍 like, 👎 dislike	Mutually exclusive (exclusive)
github	👍 👎 ❤️ 😂 😮 😢 😡 🎉	Multiple reactions at once
full	github + 🚀👀🔥👏🤔🥳⭐🍺✨💯🙏💪😎😍😕🙌	24 types. Subset via reactions_full_types

Custom types and sets: CLI or admin API.

Snippets

Snippet	Purpose
Reactions	Buttons with counts (picker / bar)
ReactionsCount	Counts without buttons
TopLiked	Top by likes
TopRated	Top by rating (likes − dislikes)
Trending	Hot items (Reddit-style formula)
ReactionsSchema	JSON-LD AggregateRating

Permissions

Policy	Description
reactions_view	View reaction data
reactions_manage	Types, sets, and bans via API
reactions_stats	Statistics

Quick links

Need	Doc
Render the block on a page	Quick start
reactions_* keys	System settings
AJAX and styles	JavaScript widget
Endpoints and error codes	REST API
recount, ban, type	CLI
Plugins	Events
Telegram / Discord / Slack	Webhooks