Skip to content

Gamification 0.9.94 / Publishing

Gamification shortcodes

Add accessible reward views to ordinary WordPress pages.

WordPress blocks and shortcodes

The block editor exposes one dynamic Cointacted Rewards block. Its sidebar setting selects the combined member view, balances, history, earned achievements, current ranks, achievement or rank catalog, quests, streaks, or a leaderboard. History has a bounded items-per-page control; leaderboard mode accepts the leaderboard ID or slug and an optional period. The block renders through the same server-side presenter and privacy policy as the shortcodes, so it works in ordinary WordPress themes without an SPA.

Gamification owns these shortcodes:

  • [cointacted_gamification]
  • [cointacted_gamification_balances]
  • [cointacted_gamification_history]
  • [cointacted_gamification_achievements]
  • [cointacted_gamification_ranks]
  • [cointacted_gamification_achievement_catalog]
  • [cointacted_gamification_rank_catalog]
  • [cointacted_gamification_quests]
  • [cointacted_gamification_streaks]
  • [cointacted_gamification_leaderboard id="monthly-reputation"]

They render accessible HTML first and progressively enhance history filters with the REST API. Assets load only when a shortcode renders. The member shortcodes show configured signed-out/empty states. SPA bridges use native route components and do not execute these shortcodes.

The achievement and rank shortcodes show the signed-in member's earned/current state. The two catalog shortcodes are discovery surfaces for published definitions and can render to signed-out visitors; hidden achievements are revealed only after the current member earns them. Definition artwork uses responsive WordPress attachment metadata and lazy loading.

The Gamification Display screen includes a canonical Display references panel. It lists the WordPress block, every shortcode, and every native application path registered by installed adapters. SnapWeb and FluentCommunity own their path definitions; future community adapters can register paths without adding provider-specific code to Gamification core. Each copyable value and enabled state comes from current saved settings.

Was this documentation helpful?Your response helps us improve this page.