Skip to content
Reactions
Reactions
Universal reactions for MODX 3 — likes, GitHub-style sets, tops and trending on any object
  1. Extras
  2. Reactions
  3. Getting started
  4. System settings

System settings

All keys use the reactions_ prefix in the reactions namespace.

Open: System → System Settings, filter reactions.

Main

KeyTypeDefaultDescription
reactions_default_settextupdownSet when the snippet omits &set (updown, github, full, or custom)
reactions_full_typestext(empty)Type subset for set=full (comma-separated names). Empty — all 24
reactions_identity_strategytextip_cookieIdentity strategy: auth_only, ip, ip_cookie, session
reactions_allow_multiplecombo-booleanNoAllow several reaction types on one object (only if the set is not exclusive)
reactions_cache_handlertextmodxCache handler: modx or redis

Identity strategies

ValueBehavior
auth_onlyLogged-in users only. Guests get an error
ipFingerprint from IP hash
ip_cookieCookie reactions_fid (32 hex), 1 year
sessionFingerprint from PHP session ID

A logged-in user is always identified by user_id, regardless of strategy.

Example reactions_full_types:

text
like,love,fire,star,clap,rocket,heart_eyes

Security

KeyTypeDefaultDescription
reactions_rate_limitnumber10Max reactions per time window
reactions_rate_limit_windownumber60Rate limit window length in seconds
reactions_block_botscombo-booleanYesReject reactions from known crawlers and bots

Integrations

KeyTypeDefaultDescription
reactions_webhooks_enabledcombo-booleanNoHTTP callbacks after reaction changes
reactions_webhook_urltext(empty)Webhook URL (JSON compatible with Telegram / Discord / Slack)
reactions_notify_authorscombo-booleanNoMessage the resource author via modUserMessage

More: Webhooks, Events.