Frequently Asked Questions
Common questions about BuddyPress Stats.
General Questions
What is BuddyPress Stats?
BuddyPress Stats is a comprehensive analytics plugin for BuddyPress and BuddyBoss communities. It tracks user activity, provides engagement metrics, and helps administrators understand community health.
Is BuddyPress Stats compatible with BuddyBoss?
Yes. BuddyPress Stats works with both BuddyPress (the free plugin) and BuddyBoss Platform. The plugin detects which platform you’re using and adapts accordingly.
Does the plugin work with Youzify?
Yes. BuddyPress Stats includes specific styling and integration for Youzify. The Statistics tab integrates seamlessly with Youzify’s navigation.
What metrics can I track?
BuddyPress Stats tracks user logins and registrations, activity posts/comments/replies, group joins/leaves/activity, friend requests and acceptances, profile updates, retention rates and user health segments.
Installation Questions
What are the requirements?
- WordPress 6.0 or higher
- BuddyPress 12.0+ or BuddyBoss Platform 2.0+
- PHP 8.0 or higher (recommended)
- MySQL 5.7 or higher
Will it slow down my site?
No. BuddyPress Stats is optimized for performance with transient caching to reduce database queries, indexed and optimized queries, fixed N+1 query issues in v1.8.0, and background processing for heavy operations.
Does it work with caching plugins?
Yes. The plugin works with popular caching plugins like WP Super Cache, W3 Total Cache, and LiteSpeed Cache. Statistics use WordPress transients which integrate well with object caching.
Data Questions
How long is data stored?
By default, activity logs are kept for 90 days. You can change this in General Settings to 30, 60, 90, or 365 days.
Is it GDPR compliant?
Yes. BuddyPress Stats includes GDPR-friendly features: IP anonymization option (removes last two octets), data retention limits, option to delete data on deactivation, and no data sent to external services.
Can I export the data?
Yes. You can export activity logs to CSV, user statistics to CSV, and custom date ranges.
Feature Questions
What is the User Health Dashboard?
The User Health Dashboard segments users into four categories based on login activity:
| Segment | Definition |
|---|---|
| Active | Logged in within 7 days |
| At Risk | Logged in 8-30 days ago |
| Dormant | Logged in 31-90 days ago |
| Inactive | No login in 90+ days |
What are Top Contributors?
Top Contributors shows your most active community members ranked by engagement (posts, comments, group activity).
Can members see their own stats?
Yes, if enabled. Members can view a Statistics tab on their profile showing their activity timeline, engagement charts, and more.
Can I show statistics on group pages?
Yes. Enable “Show Group Stats” in General Settings. Groups will display a Statistics tab with activity charts and top contributors.
Technical Questions
Does it create database tables?
Yes. The plugin creates one custom table: wp_bp_stats_activity_log to store activity tracking data.
Can I extend it with custom code?
Yes. BuddyPress Stats provides many hooks and filters for customization to control who can view stats, modify tab positions and labels, add custom statistics, and change data retention. See the Hooks & Filters Reference for details.
Does it have a REST API?
No. Statistics are accessed through the admin UI and frontend tabs. Database queries are made server-side for security and performance.
Troubleshooting Questions
Why is my dashboard empty?
Statistics only appear after users perform activities. If your dashboard is empty: Verify BuddyPress/BuddyBoss is active, Check statistics collection is enabled, Allow 24-48 hours for data to accumulate, Have users log in and post activities.
Why does “Last Login” show “Never”?
The plugin only tracks logins that occur after activation. Users who haven’t logged in since the plugin was activated will show “Never” until they log in.
Why aren’t all my users showing in health segments?
Health segments only count users who have last_login meta. Users who registered before the plugin was activated and haven’t logged in since won’t appear until they do.
Support
Where can I get help?
- Documentation: docs.wbcomdesigns.com
- Support: wbcomdesigns.com/support
- GitHub: github.com/wbcomdesigns/buddypress-stats
How do I report a bug?
Report bugs through GitHub Issues or Support ticket at wbcomdesigns.com. Include WordPress version, BuddyPress/BuddyBoss version, Plugin version, Steps to reproduce, and Error messages (if any).