Troubleshooting

Solutions to common issues with BuddyPress Stats.

Installation Issues

Plugin won’t activate

Symptoms: Error message on activation or plugin doesn’t appear active.

Solutions:

1. Check PHP version – Requires PHP 8.0+. Check in Dashboard > Tools > Site Health.
2. Verify BuddyPress is active – BuddyPress or BuddyBoss must be activated first. Activate BuddyPress, then activate BuddyPress Stats.
3. Check for conflicts – Deactivate other plugins, switch to default theme, activate BuddyPress Stats, reactivate other plugins one by one.
4. Check error logs – Enable WP_DEBUG in wp-config.php and check wp-content/debug.log for errors.

Database tables not created

Symptoms: Statistics don’t save, errors about missing tables.

Solutions:

1. Deactivate and reactivate – This reruns the activation routine.
2. Check database permissions – Your MySQL user needs CREATE TABLE permission. Contact your host if unsure.
3. Manual table creation – Contact support for the table schema. Create via phpMyAdmin if needed.

Dashboard Issues

Dashboard shows no data

Symptoms: Charts are empty, cards show zeros.

Solutions:

1. Wait for activity – Data appears after users log in and perform activities. Allow 24-48 hours for data to accumulate.
2. Verify collection is enabled – Go to General Settings, ensure “Enable Statistics” is on.
3. Check BuddyPress components – Activity component must be active. Groups component for group stats.
4. Clear cache – Go to Reset & Index, clear all caches.

Data seems incorrect

Symptoms: Numbers don’t match expectations.

Solutions:

1. Check date range – Verify the selected date range. Data only shows for selected period.
2. Clear transient cache – Cached data may be stale. Clear via Reset & Index page.
3. Check caching plugins – Page caching may serve old data. Exclude admin pages from cache.

Slow dashboard loading

Symptoms: Dashboard takes 10+ seconds to load.

Solutions:

1. Enable caching – Go to General Settings, enable transient caching.
2. Reduce data retention – Lower retention period. Less data = faster queries.
3. Check server resources – May need more PHP memory. Consider server upgrade for large communities.

Profile/Group Tab Issues

Statistics tab not appearing

Symptoms: No Statistics tab on profiles or groups.

Solutions:

1. Check settings – Verify “Show Member Stats” is enabled (for profiles). Verify “Show Group Stats” is enabled (for groups).
2. Check user permissions – User may not have permission to view. Check role-based settings.
3. Check theme compatibility – Try with a default theme. Some themes may hide tabs.
4. Clear navigation cache – BuddyPress caches navigation. Clear all caches and refresh.

Tab shows empty content

Symptoms: Tab appears but shows no statistics.

Solutions:

1. User has no activity – New users may have no logged activity. Activity only tracked after plugin activation.
2. Check JavaScript console – Open browser developer tools. Look for JavaScript errors.
3. Verify AJAX is working – Statistics load via AJAX. Check for 403/404 errors in Network tab.

Widget Issues

Widget not showing

Solutions:

1. Verify widget placement – Check widget is in active sidebar. Check sidebar is displayed on current page.
2. Check context – Single Group Widget only shows on group pages. Member Widget needs valid user context.
3. Check widget settings – Verify settings are saved. Check visibility conditions.

Export Issues

CSV export fails

Solutions:

1. Reduce data volume – Narrow date range. Large exports may timeout.
2. Check PHP limits – Increase max_execution_time and memory_limit.
3. Check file permissions – WordPress needs write access. Check wp-content permissions.

Performance Issues

High database load

Solutions:

1. Enable caching – Reduces repeated queries. Use object caching if available.
2. Optimize tables – Run optimization from Reset & Index. Scheduled weekly by default.
3. Reduce retention – Less data = faster queries. Set appropriate retention period.

Memory errors

Solutions:

1. Increase PHP memory – Add to wp-config.php: define( 'WP_MEMORY_LIMIT', '256M' );
2. Process in batches – Large operations may need batching. Contact support for guidance.

Getting More Help

If these solutions don’t resolve your issue:

1. Check documentation – Review relevant doc pages. Check for known issues.
2. Enable debug mode – Add to wp-config.php: define( 'WP_DEBUG', true ); define( 'WP_DEBUG_LOG', true );
3. Contact support – wbcomdesigns.com/support – Include debug log, WP version, plugin version.
4. GitHub issues – For bugs and feature requests: github.com/wbcomdesigns/buddypress-stats