DocsOEngage16. Gamification Engine
Reference

16. Gamification Engine

OEngageorravo.com/docs/oengage/16-gamification-engine

XP System

XP is stored in {prefix}or_xp (not user meta) for performance.

XP actions are configured in Gamification → XP Actions. Default actions:

Action KeyLabelDefault XP
registerRegister50
loginDaily Login5
fill_profileComplete Profile30
post_commentComment10
create_postPublish Post25
follow_userFollow a User5
send_messageSend a Message3

Daily login XP is only awarded once per calendar day (checked via or_last_xp_login user meta).

Levels

Levels defined in Gamification → Levels as name + minimum XP threshold. Default:

LevelNameMin XP
1Newcomer0
2Member100
3Regular300
4Active700
5Veteran1,500
6Expert3,000
7Master6,000
8Legend12,000

Level is recalculated and synced to {prefix}or_xp.level every time XP is awarded.

Streak System

  • StreakEngine::record_login() called on every successful login
  • Streak increments if last login was yesterday; resets to 1 if gap > 1 day
  • Longest streak tracked separately

Leaderboard

Cached query with 5-minute transient TTL. Cache key: or_leaderboard_{type}_{limit}.


16. Gamification Engine — OEngage Docs — Orravo