ModernStats v1.1.0

📊 Modern Statistics v1.1.0 Release Notes

📅 Release Date: 2026-01-20
👤 Author: Illusion
🧷 Compatibility: phpBB 3.2.0+

---

✨ New Features

🚫 Group Exclusion for Most Active User

• Exclude specific user groups from the "Most Active User" (Top Poster) statistic
• Perfect for excluding Administrators, Moderators, or Bot accounts
• Multi-select interface in ACP settings
• Hold Ctrl to select multiple groups

🎨 Theme Selection

• Choose between Light and Dark themes
• Configurable from ACP → Extensions → Modern Statistics → Settings
• Improved text readability in Light theme

---

⚡ Performance Improvements

🚀 Optimized Database Queries

Reduced 5 database queries by using phpBB's built-in config values:

Before (Custom Query)	After (phpBB Config)
COUNT(*) FROM users	$config['num_users']
COUNT(*) FROM topics	$config['num_topics']
COUNT(*) FROM posts	$config['num_posts']
SELECT username ORDER BY regdate	$config['newest_username']
MIN(post_time) FROM posts	$config['board_startdate']

Result: ~50-75ms faster page load

---

🐛 Bug Fixes

• Fixed: Blue bar remaining visible when all features are disabled
  • S_MODERNSTATS_ENABLED now properly checks if any feature is enabled
• Fixed: PHP warnings "Trying to access array offset on bool" when no top poster exists
  • Added null checks for $top_poster and $newest_user
• Fixed: Avatar display issues
  • Now using phpBB's native phpbb_get_avatar() function with proper key mapping
• Fixed: Undefined constant errors in namespaced code
  • Using global namespace prefix (\) for all phpBB constants

---

📝 Code Quality (phpBB Validation Compliance)

• ✅ Removed unused listener.php file
• ✅ Removed custom phpBB constant redefinitions (USERS_TABLE, etc.)
• ✅ Moved phpbb_get_user_avatar() function to class method get_user_avatar()
• ✅ Fixed HTML formatting in templates (no more multi-line tag attributes)
• ✅ Using {L_COLON} instead of hardcoded : colons
• ✅ Following phpBB coding guidelines (tabs for indentation, brackets on new lines)

---

🔄 Upgrade Instructions

1. Disable the extension in ACP → Customise → Manage extensions
2. Replace the files in ext/illusion/modernstats/ with the new version
3. Enable the extension again
4. The new migration will run automatically
5. Configure the new settings:
   • Theme: ACP → Extensions → Modern Statistics → Theme
   • Exclude Groups: ACP → Extensions → Modern Statistics → Exclude groups from Most Active User

---

📁 Changed Files

event/main_listener.php      - Major refactoring, optimizations, bug fixes
event/listener.php           - DELETED (unused)
acp/main_module.php          - Added group exclusion functionality
acp/main_info.php            - Code formatting
adm/style/acp_modernstats_body.html - Added group selection, {L_COLON} usage
styles/all/template/modern_stats.html - HTML formatting fixes
styles/all/template/event/overall_header_head_append.html - HTML formatting
styles/all/theme/modernstats.css - Improved light theme text colors
language/en/mods/modernstats_acp.php - Added new language keys
language/bg/mods/modernstats_acp.php - Added new language keys
migrations/add_excluded_groups.php - NEW: Migration for group exclusion

---

🛠️ Support

Discord illusion034 for bugs / issues / suggestions.

🖼️ Screenshots

ModernStats v1.0.0

📊 Modern Statistics Extension for phpBB

🧩 Version: 1.0.0

👤 Author: Illusion
🧷 Compatibility: phpBB 3.2.0+

---

📌 Description

Modern Statistics is a sleek and informative extension for phpBB that adds attractive and modern statistics to your forum.
It displays key forum data in a visually appealing way using a modern Bootstrap-based design and icons.

---

⚙️ Features

1. 📈 General Statistics:

• 👥 Total Members
• 🧵 Total Topics
• 💬 Total Posts
• 🏆 Most Active User
• 👁️ Total Views
• 🆕 Newest Member
• 📅 Posts Per Day
• 📊 Active Users % (last 24h)

2. 🕒 Latest Posts:

• 🗨️ Displays recent forum posts
• 👤 Includes user avatars
• 🏷️ Shows topic title, forum name, and post time
• 🔢 Configurable number of posts shown
• 🔒 Shows a lock icon for locked topics

3. 🧑‍💻 Latest Registered Users:

• 👥 Shows newly registered users
• 🖼️ Includes avatars
• 📆 Shows registration date and post count
• 🔧 Configurable number of users shown

---

📥 Installation

1. Download and extract the files
2. Upload the illusion folder to your forum's ext/ directory
3. Go to ACP → Customise → Manage extensions
4. Find Modern Statistics and click Enable

---

🔧 Configuration

In ACP → Extensions → Modern Statistics → Settings, you can configure:

• 🧭 Display location of the statistics block
• ✅ Enable/disable general statistics section
• 🗨️ Enable/disable latest posts
• 🔢 Number of latest posts to show (1-50)
• 👤 Enable/disable latest users
• 🔢 Number of latest users to show (1-50)

---

🌍 Supported Languages

• 🇬🇧 English (en)
• 🇧🇬 Bulgarian (bg)

---

📎 Requirements

• 🧩 phpBB 3.2.0 or later
• 🐘 PHP 5.4 or later

---

🛠️ Support

Discord illusion034 for bugs / issues / suggestions.

---

🖼️ Screenshots