Maintenance & Tooling

Recount balances. The ledger is the source of truth; each member's balance is a cache. If anything ever drifts, rebuild it from Settings → Maintenance → Recount all balances (batched, safe to re-run, and it reports how many balances were actually wrong). Per-member recount is available over REST.

WP-CLI. For anything at scale, the CLI avoids browser and PHP timeouts entirely:

wp voxel-points import mycred --mode=history --dry-run
wp voxel-points import csv --file=./balances.csv
wp voxel-points import-undo mycred
wp voxel-points backfill --dry-run
wp voxel-points backfill --rules=review:places,comment
wp voxel-points backfill-undo
wp voxel-points backfill-cancel
wp voxel-points expire --dry-run
wp voxel-points recount
wp voxel-points backfill-badges
wp voxel-points badge award|revoke <user> <badge>
wp voxel-points balance <user>
wp voxel-points stats

import, backfill and expire all support --dry-run, which reports exactly what would happen and writes nothing. backfill asks for confirmation before awarding; pass --yes to skip the prompt in a script.

On a large site the CLI is the better route for the backfill: it runs the whole thing in one process, with no request timeouts and no browser tab that has to stay open.

Demo data. For screenshots and for evaluating the plugin on a staging site, bin/seed-demo.php creates fifteen members with believable balances, history spread over the last ninety days, streaks, levels, badges, four rewards and a fulfilment queue:

php bin/seed-demo.php /path/to/site/public /path/to/mysqld.sock
php bin/seed-demo.php /path/to/site/public /path/to/mysqld.sock --undo

Everything it creates is tagged — demo members are prefixed vxpdemo_ and demo ledger rows carry the reference type demo — so --undo removes exactly what it added and never touches the site's own members, rewards, badges or history. History is deliberately spread across ninety days so the all-time, this-month and last-7-days leaderboards each have distinct content.

Export the ledger. Activity → Export CSV downloads exactly the rows matching your current filters — including member name and email, the rule, points, running balance, note, resolved reference, and both UTC and site-time timestamps. UTF-8 with a BOM so Excel opens it cleanly.

WP-CLI

wp voxel-points recount              # rebuild every cached balance
wp voxel-points recount --user=42    # just one member
wp voxel-points balance <id|login|email>
wp voxel-points stats                # this month's totals + top members