Installation
Requirements
Section titled “Requirements”Before installing WB Gamification, confirm your environment meets these minimums:
- WordPress 6.5 or higher
- PHP 8.0 or higher
- MySQL 8.0 or higher, or MariaDB 10.4 or higher — the leaderboard uses SQL window functions (
RANK() OVER), so older database versions are not supported
BuddyPress is optional. The plugin works on any standard WordPress site and automatically activates BuddyPress-specific features when BuddyPress is detected.
Installing the Plugin
Section titled “Installing the Plugin”From the WordPress admin:
- Go to Plugins > Add New Plugin.
- Search for WB Gamification.
- Click Install Now, then Activate.
Manual upload:
- Download the plugin ZIP file.
- Go to Plugins > Add New Plugin > Upload Plugin.
- Choose the ZIP file and click Install Now.
- Click Activate Plugin.
What Happens on Activation
Section titled “What Happens on Activation”When you activate WB Gamification, the plugin does the following automatically:
- Creates 20 custom database tables to store events, points, badges, levels, challenges, streaks, kudos, leaderboard snapshots, member preferences, and more.
- Seeds your site with 5 default levels (Newcomer, Member, Contributor, Regular, Champion) and 30 default badges.
- Registers all gamification actions appropriate for your active plugins. If BuddyPress is active, BuddyPress triggers load automatically.
- Redirects you to the Setup Wizard so you can choose a starter template.
You do not need to configure anything manually. The plugin detects your active plugins and loads the right point-earning actions automatically.
After Activation
Section titled “After Activation”You are redirected to the Setup Wizard. Choose a starter template that matches your site type — this takes about one minute. After completing the wizard, your site is fully configured and ready for members to start earning points.
If you skip the wizard, default point values are used. You can always return to Gamification > Settings to adjust them.
Multisite
Section titled “Multisite”WB Gamification can be activated per-site on a WordPress multisite network. Network-wide activation is not recommended because each site maintains its own gamification data and settings independently.