Reactions

Универсальная система реакций для MODX Revolution 3. От пары «нравится / не нравится» до набора в стиле GitHub — на ресурсе, товаре miniShop3 или любом другом объекте.

Компонент headless: менеджерского интерфейса нет. Управление через системные настройки, REST API и CLI.

Исходники: modx-pro/Reactions (MIT).

Возможности

• Три встроенных набора: updown, github, full (24 типа)
• Compact picker для github / full (layout=auto): чипы + кнопка +; layout=bar — полная полоса
• Свои типы и наборы через CLI или admin API
• Реакции на любой объект (class / class_key; в БД — object_class)
• Повторное нажатие снимает реакцию; в exclusive-наборе другая реакция заменяет предыдущую
• Стратегии идентификации: auth_only, ip, ip_cookie, session
• Топы за день / неделю / месяц / год / всё время; trending по формуле Reddit
• Rate limit, блок ботов, CSRF, Origin check
• События MODX, webhooks (Telegram, Discord, Slack), уведомления автору

Требования

MODX Revolution	3.0+
PHP	8.2–8.4
СУБД	MySQL / MariaDB (InnoDB)

Установка

1. Установите транспортный пакет Reactions через «Управление пакетами».
2. Пакет создаёт таблицы, пресеты (updown, github, full), сниппеты, чанки и системные настройки.
3. Настройки → Очистить кэш.

Сборка из исходников (нужны Node.js и npm):

composer install
php _build/build.php

build.php собирает виджет из frontend/ в assets/components/reactions/js/web/.

Быстрый путь

1. Подключите CSS/JS и вызовите [[!Reactions]] — Быстрый старт.
2. При необходимости смените набор и стратегию идентификации — Системные настройки.
3. Для витрины: miniShop3, pdoTools, SEO.

Встроенные наборы

Ключ	Реакции	Режим
updown	👍 like, 👎 dislike	Взаимоисключающие (exclusive)
github	👍 👎 ❤️ 😂 😮 😢 😡 🎉	Несколько реакций одновременно
full	github + 🚀👀🔥👏🤔🥳⭐🍺✨💯🙏💪😎😍😕🙌	24 типа; подмножество через reactions_full_types

Свои типы и наборы: CLI или admin API.

Сниппеты

Сниппет	Назначение
Reactions	Кнопки с счётчиками (picker / bar)
ReactionsCount	Счётчики без кнопок
TopLiked	Топ по лайкам
TopRated	Топ по рейтингу (likes − dislikes)
Trending	Горячие материалы (формула Reddit)
ReactionsSchema	JSON-LD AggregateRating

Права доступа

Политика	Описание
reactions_view	Просмотр данных реакций
reactions_manage	Типы, наборы и баны через API
reactions_stats	Статистика

Быстрые ссылки

Нужно	Документ
Вывести блок на странице	Быстрый старт
Ключи reactions_*	Системные настройки
AJAX и стили	JavaScript-виджет
Endpoint и коды ошибок	REST API
recount, ban, type	CLI
Плагины	События
Telegram / Discord / Slack	Webhooks