Gamification
Points, badges, leaderboards, and achievements — keeps bidders coming back beyond winning a lot.
Components
| Component | What it does |
|---|---|
| Points | Earned per bid / win / review; spent on rewards |
| Badges | One-time achievements (first bid, 10 wins, etc.) |
| Leaderboard | Public ranking by points / wins / spend |
| Achievements | Multi-step quests with progress bars |
| Daily streaks | Bonus for bidding multiple consecutive days |
Points
| Action | Points (default) |
|---|---|
| Bid placed | wkafw_points_per_bid (default 1) |
| Auction won | wkafw_points_per_win (default 10) |
| Review left | wkafw_points_per_review (default 5) |
| Daily login | (configurable) |
| Refer a friend | (configurable) |
Each customer's running points total is stored against their user profile.
What points unlock
Configure via Auctions → Settings → Gamification → Rewards:
| Threshold | Unlock |
|---|---|
| 100 points | Bronze tier — no fees on small auctions |
| 500 points | Silver tier — 5% off buyer's premium |
| 2,000 points | Gold tier — early access to flash auctions |
| 10,000 points | VIP tier — concierge support |
Each tier triggers a notification when reached.
Badges
Predefined achievement badges:
| Badge | Trigger |
|---|---|
| 🏁 First Bid | First bid placed |
| 🏆 First Win | First auction won |
| 💰 Big Spender | $1,000+ in winning bids |
| 👁️ Hawk Eye | 50+ watchlist additions |
| 📋 Reviewer | 10 reviews left |
| 🔥 Hot Streak | 5 consecutive wins |
| 🎯 Sharpshooter | 3 wins at exactly the reserve |
| 🌎 Globetrotter | Bid on auctions in 5+ countries |
| 🎁 Generous Donor | $500+ in charity auctions |
Badges display on user profile, leaderboard, and bid form (next to their name).
Leaderboard
Public ranking page at /leaderboard/ (template: templates/leaderboard.php).
| Setting | Default |
|---|---|
wkafw_leaderboard_reset | never (lifetime) |
| Leaderboard size | 100 |
Reset frequencies:
| Setting | Effect |
|---|---|
never | Lifetime leaderboard |
daily | Resets midnight UTC |
weekly | Resets Sunday midnight UTC |
monthly | Resets first of the month |
Customers can opt out of public visibility ("private mode") in their account settings.
Achievements
Multi-step quests with progress UI:
| Achievement | Steps |
|---|---|
| Auction Apprentice | Place 1 bid → Win 1 auction → Leave 1 review |
| Connoisseur | Win 5 auctions in 3 different categories |
| Charity Champion | Donate $1,000+ across charity auctions |
| Gold Rush | Reach 10,000 lifetime points |
| Watch Master | Watch 100 auctions |
Render via the Achievements widget / block (Builders).
Confetti & celebrations
Hitting a milestone triggers visual celebration:
- Badge earned → modal with badge display + share button
- Tier reached → push notification + email
- Achievement complete → modal + achievement art
Configurable via wkafw_celebrations_enabled.
Auction of the Day & flash bonuses
Bidding on the Auction of the Day or a flash auction earns 2× points (configurable multiplier).
Reporting
- Total points awarded (currency-equivalent value)
- Badges distributed
- Leaderboard top users
- Tier distribution
- Achievement completion rate
Anti-abuse
Points / badges can be gamed (e.g., placing trivial bids to farm points). Defenses:
- Bid amount minimum for points (
wkafw_min_bid_amount_for_points) - Daily points cap per user
- Points awarded only on valid bids (not retracted)
- Suspicious patterns flagged by Fraud Detection
Common questions
"Can I disable points entirely?"
Yes — set all wkafw_points_per_* to 0. The system still tracks them as 0; remove the leaderboard / achievements widgets to fully hide.
"How do I award points manually?"
"Do points expire?"
By default no. Set wkafw_points_expiry_days to enable annual / quarterly expiry.