Installation & Setup

This guide walks you through installing BuddyPress Stats and configuring it for your community.

Requirements

Before installing, ensure you have:

• WordPress 6.0 or higher
• BuddyPress 12.0+ or BuddyBoss Platform 2.0+
• PHP 8.0 or higher (recommended)
• MySQL 5.7 or higher
• Administrator access to your WordPress site

Installation

From WordPress Admin

1. Go to Plugins > Add New
2. Search for “BuddyPress Stats Wbcom”
3. Click Install Now
4. Click Activate

Manual Upload

1. Download buddypress-stats.zip from Wbcom Designs
2. Go to Plugins > Add New > Upload Plugin
3. Choose the zip file and click Install Now
4. Click Activate Plugin

Via FTP

1. Unzip buddypress-stats.zip
2. Upload the buddypress-stats folder to /wp-content/plugins/
3. Go to Plugins in WordPress admin
4. Find BuddyPress Stats and click Activate

Initial Configuration

Step 1: Access Settings

After activation, navigate to: WB Plugins > Statistics > General Settings

Step 2: Configure Data Collection

Enable Statistics: Turn on to start tracking user activity.

Data Retention: Choose how long to keep activity logs:

• 30 days
• 60 days
• 90 days (recommended)
• 365 days

Default Date Range: Set the default view for reports (Last 7 days, 30 days, etc.)

Step 3: Configure Caching

Enable Caching: Turn on transient caching for better performance.

• Cache is cleared automatically when new data arrives
• Recommended for all sites, especially those with many users

Step 4: Configure Privacy

Show Member Stats: Enable/disable stats on member profiles.

User Roles: Select which roles can view statistics.

IP Anonymization: Enable for GDPR compliance. Removes the last two octets of IP addresses.

Step 5: Save Settings

Click Save Changes. Settings apply immediately.

Frontend Setup

Profile Statistics Tab

Enable stats on member profiles:

1. Go to Settings > General Settings
2. Enable “Show Member Stats”
3. Choose which reports to display: Profile Activity Report, Engagement Report, Message Report, Group Report

Group Statistics Tab

Enable stats on group pages:

1. Go to Settings > General Settings
2. Enable “Show Group Stats”
3. Choose visibility: Which roles can see (admin, mod, member), Which group types show stats (public, private)

Widgets

Add widgets via Appearance > Widgets:

Modern Member Widget – Shows member activity summary. Also available as shortcode: [bp_stats_modern_widget]

Single Group Stats Widget – Appears on group pages only

All Groups Summary Widget – Overview of all community groups

Verifying Installation

Check the Dashboard

1. Go to WB Plugins > Statistics > Overview
2. You should see summary cards and charts
3. If charts are empty, allow 24 hours for data to accumulate

Check Database Tables

The plugin creates one custom table: wp_bp_stats_activity_log

You can verify it exists by checking phpMyAdmin or using WP-CLI:

wp db query "SHOW TABLES LIKE '%bp_stats%'"

Recommended Settings

For most communities:

Setting	Recommended Value
Data Retention	90 days
Caching	Enabled
Default Range	Last 30 days
IP Anonymization	Enabled (GDPR compliance)
Show Member Stats	Enabled
Show Group Stats	Enabled

Troubleshooting

No data showing?

• Data appears after users log in and perform activities
• Check that statistics collection is enabled
• Allow 24 hours for data to accumulate

Plugin won’t activate?

• Verify BuddyPress or BuddyBoss is active
• Check PHP version (8.0+ recommended)
• Check for plugin conflicts

Database tables not created?

• Deactivate and reactivate the plugin
• Check that your database user has CREATE TABLE permission