[XTR] Who Visited Today 1.0.0

[XTR] Who Visited Today is more than a “who’s online today” list.
It analyzes registered users’ daily activity by the hour, tracking session durations, page views, and interaction scores. With rich widget options, detailed statistic blocks, and fully automatic data management, it maps your community’s daily activity patterns in a performance-friendly way.

[XTR] Who Visited Today is a professional visitor tracking and analytics add-on for XenForo 2.3+. Its goal is not only to list who visited your forum during the day but to provide deep insights into how those users interacted with your site.

The add-on records members’ first and last visit times, total session durations, page view counts, and real-time online status. These raw data points are converted into actionable insights via advanced statistic blocks and a flexible widget interface for both admins and visitors.

Built for performance, the add-on collects data through a single event listener (appPubRenderPage), uses an intelligent throttling mechanism to prevent excessive writes, and leverages caching to keep database load minimal. A scheduled cleanup cron automatically prunes old data and triggers table optimization to maintain database health.

The widget is fully configurable from the admin control panel:
Control appearance, filters, sorting, cache lifetime, retention period and other parameters. The add-on also automatically adds a “Who Visited Today” page under the Members menu — a paginated, detailed listing of everyone who visited today, including per-user activity scores and metrics.

In short, [XTR] Who Visited Today is a comprehensive daily analytics solution that shows not only who visited, but how they participated.

Advanced Visitor Tracking​

• Records daily visits per registered user on an hourly basis.
• Tracked fields include:
  • First and last visit time
  • Session duration (session_duration)
  • Page views (page_views)
  • Visit count (visit_count)
  • Real-time online status (is_online)
• Online status is updated in real time using a short inactivity window (e.g., 5 minutes).

• Stores visits in hourly buckets to reveal traffic patterns.
• Automatically identifies the site’s most active hour.

• Easy to add to sidebar or main page.
• Filtering: Limit display to specific user groups (e.g., Premium members).
• Sorting: Sort by username, registration date, or last activity (uses add-on’s own activity data).
• Statistic blocks:
  • Daily Stats: Unique visitors, total page views, average session duration.
  • Today’s Records: Longest session, most page views, first visitor.
  • Most Active Hour: Time of peak traffic.
• Extra options: show activity score, visit count, and a “show more” control for progressive loading.

• Automatically added to the Members navigation.
• Full paginated listing of today’s visitors (default 20 per page).
• Displays enriched per-user metrics: total session duration, page views, visit count, and computed activity score.
• Combines daily summary, records, and most active hour on the same page.

• Intelligent Caching: Widget output is cached (default: 5 minutes) to minimize database queries.
• Throttling: Per-user updates are rate-limited (default: 5 minutes) to avoid excessive writes from rapid page reloads.
• Automatic Cleanup (Cron): Removes old records based on admin retention setting (default: 30 days).
• Database Optimization: Runs OPTIMIZE TABLE after cleanup to reclaim space and keep performance optimal.
• Admin Controls: Retention period (1–365 days), cache lifetime (60–3600 seconds), throttle interval (60–1800 seconds).
• XenForo Compatibility: Designed for XenForo 2.3.0+ and PHP 8.0+ with modern, efficient code.

• Respects XenForo’s existing permission system (relies on canViewMemberList).
• No extra complex permission setup required.
• Data access and repository patterns follow XenForo conventions for clean integration.