Skip to main content

Data commands

Commands for managing the statistics data stored by Burst Statistics.

install_demo_data

Populates the database with demo statistics for testing or demonstration purposes. Use this on staging sites or local development environments to work with realistic data before real traffic arrives.

Usage:

wp burst install_demo_data

Output:

Success: Demo data installed

No arguments are accepted. Running the command more than once adds additional demo rows; it does not deduplicate.

Typical use in a staging setup

Show code
# Install WordPress, activate Burst, then seed demo data in one pipeline step.
wp core install --url=staging.example.com --title="Staging" --admin_user=admin --admin_password=secret [email protected]
wp plugin activate burst-statistics
wp burst install_demo_data

reset_data

Deletes all Burst Statistics data and resets the plugin to its default state. This includes all collected hits, sessions and statistics rows.

caution

This action is irreversible. All collected analytics data will be permanently deleted. Run this on production only if you intend to start fresh.

Usage:

wp burst reset_data

Output:

Success: Data reset

No arguments are accepted.

Using --quiet in scripts

When running reset_data as part of a non-interactive script (CI teardown, environment reset), pass --quiet to suppress the success message and only surface errors:

wp burst reset_data --quiet

Combining with demo data

A common pattern for resetting a staging environment and reseeding it:

wp burst reset_data --quiet && wp burst install_demo_data --quiet

Troubleshooting

Command exits with a database error Ensure the WordPress database user has DELETE and TRUNCATE privileges on all Burst tables ({prefix}burst_hits, {prefix}burst_sessions, {prefix}burst_statistics). Some managed database setups restrict these operations.