- Phiên bản XF tương thích
- 2.3
- Addons Yêu cầu bổ sung
- XenDev Update Manager
[XenDev] Topic Readers
Topic Readers is a modern, high-performance add-on for XenForo 2.3 that shows who has read a thread—and optionally who is reading it right now.It turns ordinary thread pages into living community spaces by making user engagement visible and meaningful.
Core Goals
- Increase Interaction – Let members see who’s here and who has been here.
- Visualize Activity – Instantly understand how active a thread is.
- Better Metrics – Measure real reading behavior using time spent, not just raw view counts.
Key Features
1. Topic Readers (Last X Minutes)
Displays members who have viewed the thread within a defined time window.- Display Modes:
Avatar only, Username only, or a modern Chip style (Avatar + Username). - Reader Counter:
Shows the total number of readers. - Clean Overlay:
Optional “Show All” button to view the full list without cluttering the page.
2. Live Readers (Real-Time Presence)
Show who is currently active on the thread.- Live Counter:
Displays how many users are viewing the page right now. - Separate Time Window:
Define a short “active” window (e.g. users active in the last 5 minutes) to keep data accurate and relevant.
3. Reading Time Tracking (Total Time)
Accurately tracks how long each user spends reading a thread using background AJAX pings.- Accumulated Reading Time:
Example: “Total time spent: 11 minutes” - Smart Detection
:
Automatically pauses tracking when the tab is in the background, preventing inflated or fake statistics.
4. Top Readers (Leaderboard Widget)
A gamified leaderboard ranking users by total reading time.- Flexible Placement:
Forum index, sidebar, or any custom widget position. - Custom Limits:
Show Top 5, Top 10, or any number you prefer.
Installation & Setup
- Install
Upload the files and install via
Admin Panel → Add-ons - Configure
Go to
Admin Panel → Options → [XenDev] Topic Readers - Customize
Choose display modes, time windows, and tracking behavior. - Widgets
Place the Top Readers leaderboard at
Appearance → Widgets
Recommended Settings
For the best balance between engagement and server performance:| Setting | Recommended Value | Reason |
|---|---|---|
| Reader Time Window | 60 – 1440 mins | Covers most daily activity |
| Live Window | 3 – 10 mins | Keeps live readers relevant |
| Ping Interval | 15 – 25 secs | Accurate tracking without server strain |
| Leaderboard Limit | Top 10 | Ideal for sidebar visibility |
Who Is This Add-on For?
- Active Communities
Forums that want to showcase real engagement. - Data-Driven Admins
Those who care about how long content is read, not just clicked. - Gamified Forums
Communities that use rankings and competition to encourage content consumption.