Orravo, Abuja Digital Studio

Tiers

Tiers are VIP levels (2 to 10 per program). Each tier carries qualification rules and perks. Members are bumped between tiers automatically as they earn points and spend.

Tier row shape

wp_oloyalty_tiers:

name - display label
rank - ordering; higher rank wins when multiple tiers qualify
qualification_rules - JSON (see below)
perks - JSON list of perks
color, icon - visual identity

Qualification rules

OLoyalty_Tiers::qualifies($tier, $member) evaluates these keys in qualification_rules:

lifetime_points - minimum lifetime points earned
points_in_window + window_days - rolling-window points (for example 5,000 points in 365 days)
lifetime_spend - minimum lifetime spend in WC orders

A member qualifies for a tier only if every present rule is satisfied. The highest-ranked qualifying tier wins.

Evaluation triggers

OLoyalty_Tiers::evaluate_member($member_id) is called:

After every successful earn (from the points engine)
Manually from the admin via the Members bulk action recalculate_tier
Globally on the oloyalty/tiers/recalculate cron hook (also reachable as a REST POST to /oloyalty/v1/tiers/recalculate)

Tier change event

When a member's tier changes, OLoyalty:

Updates members.tier_id and tier_qualified_at.
Dispatches oloyalty/tier/changed with (member, old_tier, new_tier).
OMailer can pick up that event to send a tier-up email; OEngage can mirror to XP.

Perks

Perks are interpreted by other engines. Common patterns:

Earn multiplier (1.5x points for Gold members)
Free shipping at checkout
Gated rewards (only Platinum can redeem)
Tier badge displayed in My Account