Wbcom Designs
Store Talk to us
Release notes / WB Gamification
BuddyPress Add-on Plugin

WB Gamification

Members come once and never come back. GamiPress and myCred treat gamification as a points calculator. WB Gamification is a retention layer: points, badges, levels, leaderboards, challenges, streaks, kudos, all tied to BuddyPress, WooCommerce, LearnDash, bbPress activity. Pick a template, members start earning in 60 seconds.

8 releases
v1.5.3 latest
June 2, 2026 shipped
View product → View on store GitHub releases →

v1.5.3 Latest

June 2, 2026
New 8 Dev 1

New

  • Settings > Access: exclude roles or specific accounts (administrators, staff, support agents, bots) from earning points, badges, levels, and streaks. Excluded members keep existing points but stop accruing and are hidden from leaderboards.
  • Members admin page (Gamification > Members): a searchable, paginated roster of every member with points, level, and badges, plus per-member award, exclude or include, and reset-points actions.
  • Bulk award: grant the same points to every member of a role, or to all members at once, from the Award Points page. Excluded accounts are skipped automatically.
  • Settings > Tools: export the plugin configuration to a JSON file and import it on another site. Runtime data is excluded so a config move never corrupts the target site.
  • Settings > Tools: a Rebuild Leaderboard button that recomputes the snapshot and clears its caches, for when the leaderboard looks stale after a manual award or import.
  • Settings > Modules: turn off engagement modules your community does not use (kudos, streaks, challenges, community challenges, cohort leagues, redemption store). A disabled module renders nothing and its admin page is hidden; nothing is deleted, so re-enabling restores it. Points, badges, levels, and leaderboards are always on.
  • Settings > Points: optional point expiry, off by default. When enabled, a daily job decays the balance of members who have not earned for a chosen number of days, to nudge re-engagement.
  • Settings > Tools: Reset all member progress. Permanently clears accumulated member data (points, badges, streaks, kudos, leaderboards, redemptions, submissions) while keeping all configuration and definitions. Requires explicit confirmation.

Dev

  • New admin-only REST endpoints under the wb-gamification/v1 namespace (members, exclude and reset, bulk points, and tools for export, import, recompute, and reset), plus developer hooks for earn eligibility, module state, progress reset, and point decay.

v1.5.2

June 2, 2026
New 5 Improve 6 Fix 5 Dev 1 Compat 1

New

  • BuddyPress profile Achievements tab with Overview, Badges, Points, and Streak sub-tabs, showing the member points, level progress, streak, badges, and points history. Viewable on your own profile and other members.
  • WooCommerce My Account Achievements endpoint (/my-account/achievements/) for stores running WooCommerce without BuddyPress. Shows the member full gamification dashboard with a link to the Hub page. Loads only when WooCommerce is active.
  • Optional LearnDash profile My Achievements link to the gamification dashboard. Off by default.
  • Admin setting for notification placement (Settings > Realtime): bottom-right by default, plus bottom-left, top-right, and top-center, with a corner-aware slide-in.
  • On Jetonomy sites the leaderboard defers to Jetonomy reputation ranking, since the two rankings are identical. The wb-gam leaderboard and top-members blocks, shortcodes, and Hub card are hidden so members see one leaderboard. Badges are unaffected.

Improve

  • Realtime updates now default to WP Heartbeat instead of a streaming connection, removing a long-poll that tied up a PHP worker per logged-in page. Streaming is opt-in.
  • Heartbeat polls every 15 seconds at rest (was 5), bursts to 5 seconds for 30 seconds after a member action, and nearly suspends on backgrounded tabs.
  • Member directory, leaderboard, and top-members no longer run per-row queries; the query count is now constant regardless of community size.
  • Reward toasts always state what the points were for, using the action label or the admin-entered reason.
  • Frontend surfaces (Hub, blocks, member profile) map their neutral colors to the active theme tokens, so they follow BuddyX and BuddyX Pro light and dark mode automatically. Themes without those tokens keep the original light palette.
  • My Badges flyout now shows two columns so each badge art, title, and description are readable instead of cramped three-up.

Fix

  • Toast notifications no longer overlap the theme header or navigation.
  • Duplicate toasts when both delivery methods sent the same event.
  • Points toast showed a contextless count instead of naming the action.
  • Member profile pages returned 404 for everyone because public visibility required an opt-in no screen ever set. Public profiles are now on by default, and the owner and admins can always view a profile.
  • Removed em-dashes from all user-facing labels and descriptions per house style; hyphens only. Existing seeded badge descriptions were migrated in the database too.

Dev

  • BuddyPress, WooCommerce, and LearnDash achievement surfaces share one renderer with a single filter, so all three reuse the same blocks and Hub link with no duplicated display logic. Streaming connections and batch cache-prime helpers for points and badges are available for hosts and listings that need them.

Compat

  • Jetonomy badges and reputation continue to award points (badge earned, reputation change, space join, polls, messages); wb-gam adds the levels, streaks, challenges, and redemption layer on top.

v1.5.1

June 1, 2026
Fix 2 Compat 1

Fix

  • Fixed a fatal error that crashed sites on PHP 8.1 and below, caused by type declarations only valid in newer PHP versions.
  • Fixed additional parsing errors on PHP 8.0 from newer-PHP-only syntax, so the plugin runs cleanly on PHP 8.0 again.

Compat

  • Minimum supported PHP lowered from 8.1 to 8.0. Continuous integration now tests PHP 8.0 through 8.4.

v1.5.0

May 30, 2026
New 3 Improve 6 Fix 18 Security 1 Dev 1

New

  • Manual-award form on the Badge edit screen lets admins grant any rule-driven or manually-awarded badge to a chosen member without writing SQL.
  • Members can now attach media to achievement submissions. The upload permission is granted only while the submission editor is open, so the Add Media button works for non-admins without exposing the full Media Library. Opt-out filter: wb_gam_grant_member_uploads.
  • Action Scheduler safety valve plus a drain command (wp wb-gamification as drain) for sites whose background-task queue has grown past safe limits.

Improve

  • Toast notifications now refresh on a fast 5-second interval on gamification surfaces so realtime feedback feels immediate.
  • Earning Guide cards put the action label below the icon and points row so long action names no longer wrap vertically in a cramped column.
  • Cohort Rank block gets tier-coloured accents (Bronze, Silver, Gold, Diamond).
  • Community Challenges block now has a proper completed-state look (green pill plus gradient card) so finished challenges read distinctly from active ones.
  • User Status Bar block now sits below custom theme admin bars and has a cleaner expand and collapse toggle.
  • Activity Stream block alignment tightened to match Reign social-feed conventions.

Fix

  • Point-type conversion now credits the destination currency. Previously the source points were debited but the credit was never written, so members lost points on every conversion. Conversions now run as one atomic debit-plus-credit with a single audit entry.
  • Badge award conditions are saved atomically. A failed save no longer leaves a badge with no condition (which silently stopped it auto-awarding); the editor now reports an error instead of a false success.
  • API key creation verifies the key was stored before returning it, so admins are never handed a key that was never saved and can never authenticate.
  • Submission approval only marks a submission approved once its points award succeeds; on failure the submission stays pending instead of approving with zero points.
  • Admin save actions across challenges, community challenges, levels, rules, webhooks, rewards, and badges now report a real error on a database failure instead of silently reporting success, and multi-row deletes roll back together.
  • Deactivating the plugin now clears every scheduled background task, leaving no orphaned events behind.
  • Setup Wizard now triggers on first activation in CLI and one-click sandbox flows, and covers restore-from-backup and container-clone scenarios that previously bypassed the activation hook.
  • WooCommerce purchase points are now awarded the moment the gateway confirms payment, not whenever an admin manually marks the order complete. First-purchase detection counts processing and completed orders together.
  • The redemption confirmation email now actually sends when its per-event toggle is enabled.
  • Redemption Store block now reads a stock value of 0 as Unlimited instead of Out of stock, matching the admin setting.
  • Hub Challenges card now surfaces in-flight community challenges alongside personal challenges.
  • Community challenge bonus awards no longer get lost; every contributor now reliably receives the bonus.
  • Completed community challenges remain visible until their expiry instead of vanishing the instant the global goal is hit.
  • Cohort tier names edited on the Cohort Settings admin page now flow through to the Cohort Rank block.
  • Duplicate toast notifications are eliminated, closing a race that produced repeated bubbles.
  • Default badge conditions corrected to match their names: First Post, Prolific Writer, and Content Creator now track published posts; First Comment and Engaged Reader track comments. Replaces a placeholder that previously fired on the wrong trigger.
  • The leaderboard nudge no longer enters an infinite background-task loop on some databases. Closes a runaway that generated millions of scheduled rows on one production install.
  • Fixed a boot issue that could hide the Gamification admin menu on some installs.

Security

  • The member upload permission is now scoped to the achievement-submission flow instead of being granted site-wide to every logged-in user, closing a privilege-escalation and storage-abuse vector on open-registration communities.

Dev

  • Admin UI colours are now fully tokenized, so a single palette edit re-themes the whole admin interface.

v1.4.0

May 1, 2026
New 5 Improve 7 Fix 8 Dev 2

New

  • Give-kudos block + shortcode (wb-gamification/give-kudos, [wb_gam_give_kudos]) for sending kudos from any frontend page.
  • Per-action cooldown + daily-cap admin override (Points settings table) with autosave to /actions/{id}/overrides REST.
  • ActionSchedulerCleaner daily cron prunes pending, failed, and complete action-scheduler rows older than 7 days (filter wb_gam_as_retention_days).
  • Jetonomy free integration manifest covers four previously-unrewarded events: joining a space, approval into a gated space, trust-level promotion (TL0 to TL5), and paid-membership activation (RCP / PMPro / MemberPress / WooCommerce Subscriptions / Sensei / LearnDash / MasterStudy / Tutor / LifterLMS).
  • Jetonomy Pro DM-received signal (recipient side) now earns gamification points with cooldown plus daily cap to prevent spam-DM gaming.

Improve

  • Settings dashboard container now uses 1600px max-width on wide monitors and consolidates a duplicate .wbgam-wrap rule.
  • Challenges and Community Challenges admin pages unified under a single Challenges menu entry with Individual / Community tabs.
  • Async award flag dropped on five low-volume BuddyPress + WPMediaVerse actions so points update synchronously without Action Scheduler delay.
  • Admin notices now render above the WB Gamification chrome instead of being visually trapped inside .wbgam-wrap.
  • Configure Points and Top Actions dashboard links route to the in-page Points tab via hash anchor instead of broken query-string routing.
  • Leaderboard rows now show points-with-icon and badges-earned count next to each member; member directory entries now display Level, Points, and Badge count instead of just the level name.
  • JetonomyIntegration class no longer registers three filter listeners (jetonomy_reputation_points_map, jetonomy_reputation_pre_change, jetonomy_leaderboard_items) that have no emit sites in upstream Jetonomy 1.4.4. Listeners were dead wiring; removal clears confusion about which contracts the integration actually honors. Sandbox veto via wb_gam_sandboxed user meta now runs on the working jetonomy_reputation_changed mirror path instead.

Fix

  • LeaderboardNudge no longer enqueues duplicate Action Scheduler jobs for the same user; a runaway loop on long-running sites is contained by the new as_has_scheduled_action guard.
  • Challenge time queries use UTC_TIMESTAMP() instead of NOW() so UTC-stored start and end columns activate at the correct moment on servers with a non-UTC MySQL session timezone.
  • datetime-local admin inputs hydrate UTC values into the browsers local time on page load so the Challenges and Community Challenges edit forms no longer drift the saved time by the timezone offset on every edit.
  • Level-up and streak-milestone toasts now include a translated message string so the toast bubble is no longer empty.
  • ChallengeEngine duplicate do_action removed so BP activity rows, webhook deliveries, and emails fire once per challenge completion instead of twice.
  • KudosController create_item resolves recipient_login (username or email) server-side for the new give-kudos block; receiver_id remains supported.
  • BuddyPress activity filter labels now expose four distinct entries (Badge earned, Level up, Kudos sent, Challenge complete) instead of collapsing into one Gamification row; sites can override via the wb_gam_activity_context_label filter.
  • Gamification top-level admin menu icon now renders on every wp-admin page (Lucide font + the icon-paint CSS rule are enqueued globally so the icon does not disappear when viewing Posts, Pages, Tools, etc.).

Dev

  • New wb_gam_as_retention_days filter (default 7) to tune Action Scheduler retention per site.
  • New wb_gam_activity_context_label filter exposes BP activity context labels for per-type customisation.

v1.3.0

May 1, 2026
New 4 Fix 3

New

  • Jetonomy 1.4.3 reputation and leaderboard integration.
  • Jetonomy Pro event triggers for polls, direct messages, badges, and reactions.
  • WPMediaVerse Free and Pro integration manifests shipped in-tree so the host site no longer carries the manifest layer.
  • Engine now fires wb_gam_award_skipped from every silent-skip path so integrations can react to skipped awards.

Fix

  • Points history view renders the manifest label instead of the raw action_id.
  • WPMediaVerse handlers use upstream hook arguments instead of a broken static lookup.
  • Boot path shows an admin notice instead of a fatal error when vendor/ is missing.

v1.2.0

May 1, 2026
New 1 Improve 2 Dev 1

New

  • EDD SDK integration for automatic plugin updates from wbcomdesigns.com.

Improve

  • Consolidated admin stylesheets into a single admin.css.
  • Populated admin dashboard with KPI cards, top actions, top earners, and a daily sparkline.

Dev

  • submit-achievement view.js is translation-ready.

v1.0.0

Note 16

Note

  • First public release.
  • 30 pre-built badges with point milestone and action count auto-award conditions.
  • 5-level progression system (Newcomer to Champion) with configurable thresholds.
  • Leaderboard with snapshot caching, group scoping, and 4 time periods.
  • Individual challenges with admin manager, bonus points, and date ranges.
  • Daily streak tracking with grace period, 7 milestones, and bonus rewards.
  • Peer kudos with daily limits, receiver/giver points, and feed display.
  • 17 Gutenberg blocks and 15 shortcodes for frontend display.
  • REST API with 65 endpoints across 24 controllers.
  • WP Abilities API registration (12 abilities) for AI agent discovery.
  • 9 first-party integration manifests (BuddyPress, bbPress, WooCommerce, LearnDash, LifterLMS, MemberPress, GiveWP, The Events Calendar).
  • Setup wizard with 5 starter templates (Blog, Community, Course, Coaching, Nonprofit).
  • Modern admin UI with sidebar navigation, card layout, and field descriptions.
  • Analytics dashboard with 6 KPI cards, top actions/earners, daily sparkline.
  • Toast notifications via Interactivity API and REST polling.
  • 60+ pages of documentation at docs/website/.

Seriously, one of the best software tech experiences I've ever had!

After 16 years of buying WordPress themes and plugins, I know exactly what bad support looks like and Wbcom Designs is the polar opposite. My setup was a nightmare: multiple tools, deep integrations, custom configurations that required…

Duston McGroarty US