[XenCustomize] Time Spent Online 2.1.3

XenCustomize Time Spent Online tracks and displays how much time users have spent on your XenForo forum—creating a fun, competitive, and interactive experience for your community!

This feature motivates engagement, encourages competition, and enhances community interaction effortlessly. With detailed statistics, interactive charts, and a real-time tracking system, admins can gain valuable insights into user activity.

​

Track & Display Online Time
✔ Show the total time users have been active on your forum.
✔ Displays community-wide time spent in the Forum Statistics widget.
✔ Track top engaged user based on online activity.

Time Spent Statistics Dashboard
✔ Comprehensive stats page with detailed insights.
✔ View your time spent today, your average daily time, and comparisons with others.
✔ Track the most active user of the day and community-wide engagement.
✔ Interactive bar charts for Age, Gender, and Country-based engagement (fully admin-controllable!)

Seamless Integration
✔ Displays in messages, profiles, and member statistics.
✔ Forum Statistics Widget integration to highlight total time spent by all users.
✔ Sub-navigation link under "Members" for easy access to the Time Spent Statistics Dashboard.

Member Stats Integration
✔ Displays Top Users by Time Online to recognize and reward most engaged members.
✔ Helps gamify your community by encouraging participation.

Permission-Based Control
✔ Set who can see time spent online — ideal for premium or ranked users.
✔ Control who can access the Time Spent Dashboard.

Real-Time & Accurate Tracking
✔ Uses intelligent session tracking to avoid counting idle time.
✔ Efficient tracking system that does not impact performance.

Smart Performance Handling
✔ Uses Cron & Job Queue for optimized performance.
✔ No performance loss even on large forums.

Migration from Other Add-ons
✔ Seamless migration from [Yugensoft] Time Spent Online v2.0.6 without losing any data!
✔ Seamless migration from [WMTech] Time Spent Online v2.0.3 without losing any data!

---

Comprehensive Time Statistics Dashboard:

• Introduced a detailed front-end Time Spent Overview page showcasing various online activity metrics:
  1. Community-Wide Average Daily Time
  2. Your Time Spent Today
  3. Your Average Daily Time
  4. Your Online Time Compared to Other Users
  5. Most Active User Today
  6. Total Time Spent by the Community Today
  7. Time Spent by Age Group
  8. Time Spent by Gender
  9. Time Spent by Country

Interactive CSS Charts for Better Visualization:

• Implemented bar charts to enhance data representation for:
  • Time Spent by Age Group
  • Time Spent by Gender
  • Time Spent by Country
• Uses color-coded bars to indicate low, medium, and high engagement levels for a more intuitive user experience.

New Navigation Link:

• Added a new sub-navigation link under the "Members" navigation for quick access to the Time Spent Statistics page.
• Fully permission-controlled, accessible only to users with the "Can view time spent statistics" permission.

New User Group Permission:

• "Can view time spent statistics" – Allows admins to control who can access the statistics dashboard.

New Admin Options to enable/disable:

• Time Spent by Age Group
• Time Spent by Gender
• Time Spent by Country

New Style Properties for customization:

• Stats Cards
• Stats Summary
• Bar Chart Colors

---

Forum Post Integration

• Displays total time spent online in the message user info block.
• Integrated with "Message user info elements" style property for easy toggle.
• Visible to users based on permissions (view own or others' time).

User Profile & Member Tooltip Display

• Users can view their own total online time in their profile.
• Moderators (with permission) can view other users' total online time.
• Displays total time spent online in the XenForo "Member Tooltip" when hovering over usernames.

Forum Statistics Widget Integration

• Adds Total Members’ Online Time to the Forum Statistics widget.
• Visible only to users with the correct permissions.
• Helps showcase overall community engagement at a glance.

Leaderboard (Member Stats)

• Lists top users by time spent online, encouraging competition.
• Automatically creates a dedicated leaderboard on the Member Stats page upon fresh install.
• Displays each user’s total cached time spent online.
• Visibility controlled via "Can view time spent online of others" permission.

Permission-Based Control

• "Can view own time spent online" – Users can see their own stats.
• "Can view time spent online of others" – Useful for moderators, premium or ranked users.

Bot & Guest Filtering

• Tracks only valid logged-in users, ignoring guests, bots, and banned accounts.
• Ensures only active sessions are tracked, ignoring inactive sessions.

Fully Automated Updates

• Uses Cron Jobs & XenForo's Job Queue to handle tracking in the background.
• Adds a new cron entry: "Update Time Spent Online".
• A dedicated Job Queue efficiently updates tracking data.

[WMTech] Time Spent Online Migration

• Automatic data migration from [WMTech] Time Spent Online v2.0.3 upon installation.
• Ensures seamless transition with zero data loss.
• Runs automatically if previous add-on data is detected.

[Yugensoft] Time Spent Online Migration

• Automatic data migration from [Yugensoft] Time Spent Online v2.0.6 upon installation.
• Ensures seamless transition with zero data loss.
• Runs automatically if previous add-on data is detected.

No Core Edits Required

• Uses template modifications for seamless installation.

XenForo 2.3+ Compatible

• Fully compatible with XenForo 2.2 and XenForo 2.3.