Boost user engagement and participation with a comprehensive gamification system. Reward contributions, celebrate achievements, and foster healthy competition across your social network.

✨ Key Features

⚡ Trackable Actions

Points are automatically awarded when users perform these actions:

🏅 Badge Tiers

🎯 Pre-built Badges

• 🏆 First Post - Created your first post
• 📰 Publisher - Created 100 posts
• 👑 Content King - Created 500 posts
• 💬 Conversationalist - Posted 50 comments
• ❤️ Popular - Received 100 likes
• ⭐ Social Butterfly - Received 500 likes
• 🧭 Explorer - Joined 10 spaces
• 👥 Community Member - Joined 25 spaces
• 📅 Dedicated - 30-day login streak
• 🔥 Super Dedicated - 100-day login streak
• 👤 Complete Profile - Filled out profile
• 📤 Sharer - Uploaded 25 files
• 📚 Knowledge Builder - Created 10 wiki pages
• 📅 Event Organizer - Created 15 events
• ✅ Task Master - Completed 50 tasks
• 🏆 Top Contributor - Multi-achievement combo
• 🎖️ Community Champion - Ultimate combo badge

🚀 How It Works

🔧 Admin Features

• 📊 Dashboard Overview - View total users, points awarded, badges earned at a glance
• ⚙️ Point Value Configuration - Customize points for each action type
• 🎁 Manual Point Awards - Grant bonus points to specific users
• 🏅 Badge Management - Create, edit, and delete badges with custom criteria
• 🎯 Achievement Builder - Design achievements with flexible triggers
• 📋 Leaderboard Control - Configure cache duration and rebuild rankings
• ✅ Verification Queue - Approve achievements requiring manual verification
• 🔒 Anti-Gaming Settings - Set daily limits and cooldowns

👤 User Experience

📋 Requirements

Gamification & Engagement Module v1.0 | Compatible with HumHub 1.17.x
Built for community builders 💜

🏆 Gamification & Engagement Module

A comprehensive gamification system for HumHub 1.17.x that rewards user participation with points, badges, achievements, and leaderboards.

🪙 Points System

• Automatic point awards for user actions
• Customizable point values per action
• Manual point awards by admins
• Weekly and monthly point tracking
• Point decay option (configurable %)
• Anti-gaming protection with daily limits
• Cooldown between repeated actions

Supported Actions:

• Post created
• Comment posted
• Like given
• Like received
• Space joined
• Daily login
• Profile completed
• File uploaded
• Wiki page created
• Poll created
• Event created
• Task created
• Task completed

📈 Level System

• Automatic level calculation based on total points
• Progressive level thresholds (Level² × 100 points)
• Visual progress bar to next level
• Level-up notifications
• Level displayed on leaderboards and profile

🎖️ Badges

• 17 pre-built badges included
• 4 tier system: Bronze, Silver, Gold, Platinum
• Create unlimited custom badges
• Bonus points awarded when badge earned
• Secret badges (hidden until earned)
• Featured badges on user profile
• Badge progress tracking

Badge Criteria Types:

• Action Count – Earn after X number of actions
• Points Threshold – Earn at X total points
• Streak – Consecutive days of activity
• Combination – Multiple conditions required
• Custom – Define your own logic

Included Badges:

🎯 Achievements

• Create custom achievements with flexible triggers
• Optional admin verification requirement
• Repeatable achievements supported
• Progress tracking with visual indicators
• Can award badge when achievement completed
• Secret achievements (hidden until unlocked)
• Categorized by type (contributor, social, etc.)

Trigger Types:

• Action Count – Complete X actions
• Streak – X consecutive days
• Combination – Meet multiple criteria
• Custom – Custom trigger logic

📊 Leaderboards

• Global leaderboard (all-time points)
• Monthly leaderboard (resets each month)
• Weekly leaderboard (resets each week)
• Space-specific leaderboards
• User rank display
• Badge count shown on leaderboard
• Smart caching for performance
• User opt-out option
• Manual rebuild from admin panel

⚙️ Admin Panel

Dashboard:

• Total active users count
• Total points awarded
• Total badges earned
• Total achievements completed
• Pending verifications queue
• Top 10 users display

Management:

• Configure point values per action
• Award/deduct points manually
• Create, edit, delete badges
• Create, edit, delete achievements
• Verify pending achievements
• Rebuild leaderboard cache

Settings:

• Enable/disable points system
• Enable/disable badges
• Enable/disable leaderboards
• Enable/disable achievements
• Enable/disable notifications
• Enable/disable point decay
• Set point decay rate (%)
• Set max points per action per day
• Set min seconds between actions
• Set leaderboard cache duration
• Allow/disallow leaderboard opt-out

👤 User Features

Dashboard Widgets:

• Points & level display
• Progress bar to next level
• Weekly points summary
• Badge count
• Mini leaderboard

Achievement Page:

• Earned badges gallery
• Badge progress tracker
• Completed achievements list
• Achievement progress tracker
• All badges by category
• Feature badges on profile

Leaderboard Page:

• View all-time rankings
• View monthly rankings
• View weekly rankings
• See personal rank
• View space leaderboards

🔔 Notifications

• Badge earned notification
• Achievement completed notification
• Level up notification
• Points awarded notification (for large awards)
• Email notifications supported
• Users can manage notification preferences

🔗 HumHub Integrations

• Admin menu integration
• Top menu leaderboard link
• Dashboard sidebar widgets
• Space menu integration
• User profile menu (achievements)
• Activity stream (badge/achievement activities)
• Works with: Posts, Comments, Likes, Spaces, Files, Wiki, Polls, Calendar, Tasks

🛠️ Technical Details

Requirements:

• HumHub 1.17.x
• PHP 8.0+
• MySQL 5.7+ / MariaDB 10.2+

Database Tables:

• gamification_user_points – User point balances
• gamification_point_transaction – Point history log
• gamification_badge – Badge definitions
• gamification_user_badge – User earned badges
• gamification_achievement – Achievement definitions
• gamification_user_achievement – User achievements
• gamification_leaderboard_cache – Cached rankings
• gamification_activity_log – Anti-gaming tracking

Scheduled Jobs:

• Rebuild leaderboards (hourly/daily)
• Reset weekly points (weekly)
• Reset monthly points (monthly)
• Apply point decay (monthly, if enabled)
• Cleanup old data (daily)

Gamification & Engagement Module v1.0
Compatible with HumHub 1.17.x