TK bbPress Stats

Automatic Installation

1. 01Log in to your WordPress admin panel
2. 02Navigate to Plugins > Add New
3. 03Search for “TK bbPress Stats”
4. 04Click “Install Now” and then “Activate”

Manual Installation

1. 05Download the plugin zip file
2. 06Upload the folder tk-bbpress-stats to the /wp-content/plugins/ directory
3. 07Activate the plugin through the ‘Plugins’ menu in WordPress
4. 08Configure the widget in Appearance > Widgets or use the shortcode

Widget Usage

1. 09Go to Appearance > Widgets
2. 10Drag “TK bbPress Stats” to your desired widget area
3. 11Configure which statistics to display
4. 12Save your settings

Shortcode Usage

Insert this shortcode in any post or page: [widget widget_name=”TK_bbPress_Stats”]

Then configure display options in Settings > TK bbPress Stats

Requirements

1. 13WordPress 5.0 or higher
2. 14bbPress plugin installed and activated
3. 15PHP 7.4 or higher (PHP 8.0+ recommended)

What statistics can this widget display?

The widget can show: * Total Users * Total Topics * Total Replies * Total Posts (topics + replies combined) * Total Forums

Each statistic can be individually enabled or disabled.

Does the widget count unpublished or trashed content?

No, only published topics, replies, and forums are counted.

Is this plugin compatible with PHP 8.5?

Yes! Version 2.0.0 is fully compatible with PHP 8.5 while maintaining backward compatibility with PHP 7.4+.

How does caching work?

Statistics are cached for 1 hour by default. The cache automatically clears when: * A new topic is created * A new reply is posted * A new forum is created * A user registers or is deleted

Is this plugin secure?

Yes, version 2.0.0 includes comprehensive security improvements: * SQL injection protection with prepared statements * XSS prevention with proper escaping * Input sanitization * Capability checks * Path traversal protection

Will upgrading from v1.x break my site?

No, version 2.0.0 is fully backward compatible. Your existing settings and widget configurations will be preserved.

Can I customize the cache duration?

Yes, add this to your wp-config.php: define(‘TK_BBPRESS_STATS_CACHE_EXPIRATION’, 3600); // seconds

Does this work with multisite?

Yes, the plugin works with WordPress multisite installations.

How do I translate this plugin?

The plugin is fully internationalized. Use a translation plugin like Loco Translate or create .po/.mo files in the /lang directory.