[XTR] Daily Login Streak 1.0.0

Maximize Community Engagement with [XTR] Daily Login Streak​

Maintaining consistent, daily user retention is one of the most critical objectives for any thriving online community. [XTR] Daily Login Streak introduces a powerful gamification framework specifically built from the ground up for XenForo 2.3.x, designed to encourage members to visit and interact with your forum every single day.

By rewarding consecutive daily logins and visualizing user commitment through interactive calendars, GitHub-style annual heatmaps, and leaderboard widgets, this add-on transforms passive visitors into active daily contributors.

How the System Works​

The core engine of [XTR] Daily Login Streak operates through an optimized lifecycle:

1. Automated Detection & Session Verification: When an authenticated member loads any public page on your forum, the system checks whether their visit for the current calendar day has already been acknowledged within their session. If not recorded, the streak recorder is executed instantly without unnecessary database overhead on subsequent page views.
2. Timezone-Aware Calculation: Every member's daily reset is calculated against their localized timezone and date preferences rather than a rigid server-wide UTC clock, ensuring fair streak progression regardless of geographic location.
3. Streak Progression & Record Tracking: Logging in on consecutive days increments the user's active streak count, automatically updates their lifetime longest streak record, and increases their total historical login days counter.
4. Streak Freeze Protection: Real life happens. If an administrator configures a streak freeze grace period or grants freeze permissions, members who miss a day can have their streak preserved rather than immediately reset to zero.
5. Automated Maintenance Cron: A high-performance scheduled task periodically scans for broken streaks that have exceeded the allowable cutoff hour and grace window, executing direct bulk database updates without memory bloat.

Comprehensive User Experience & Visual Interface​

1. Dedicated Account Management Hub​

Members have access to a dedicated dashboard located at account/daily-streak, seamlessly integrated into the standard XenForo account navigation sidebar:

• Summary Statistics: Quick-view statistics displaying Current Streak, Longest Streak, and Total Login Days.
• Milestone Progress Bar: Visual cycle markers depicting the member's progression through their current streak cycle (e.g. 7-day, 14-day, or 30-day cycles).
• GitHub-Style Yearly Activity Heatmap: A full 365-day color-coded activity matrix displaying login intensity across all 12 months. Users can easily browse past years through dynamic tabs.
• Interactive Monthly Calendar: A structured calendar view marking successful login dates, highlighting the current day, and allowing instantaneous month-by-month navigation powered by Vanilla JavaScript AJAX handlers.

2. Dynamic Navigation Bar Dropdown​

When enabled, an eye-catching flame icon appears in the main user navigation bar alongside alerts and conversations.

• Includes an unread badge notification counter alerting members to newly achieved streak progress.
• Clicking the trigger opens a structured dropdown menu loaded asynchronously on demand, presenting a real-time summary, milestone icons, and a mini monthly calendar without slowing down initial page loads.

3. Message User Info & Postbit Integration​

Display member dedication directly inside forum discussions. The add-on integrates with XenForo's native style properties, allowing administrators to toggle streak display inside thread posts and conversations while respecting viewer privacy permissions.

4. Top Streaks Leaderboard Widget​

A customizable widget that can be placed anywhere across your forum (sidebar, forum list, member list). It showcases top members with the longest active streaks, featuring distinctive rank badges for 1st, 2nd, 3rd, and subsequent positions.

Deep Integration with Core XenForo Systems​

• Trophies, Promotions & User Criteria: Natively extends XenForo user criteria with three dedicated rules: Current Streak (at least X days), Longest Streak (at least X days), and Total Login Days (at least X days). Use these criteria to automatically award trophies, trigger notices, or promote members to VIP user groups.
• Alerts and Web Push Notifications: Congratulate members when they reach milestone achievements (7, 14, 30, 60, 90, 180, 365+ days) or when their streak is saved by Streak Freeze. Members retain full control via XenForo alert preference opt-outs.
• Full Style Property Customization: Easily customize all colors, fire icons, crown icons, calendar cell states, and 5-level heatmap intensity shades through the XenForo Style Properties system without editing template code.

Economy & Credits Integration​

[XTR] Daily Login Streak includes built-in event handlers for economy systems:

• DragonByte Credits Integration: Features a native Event Trigger handler that automatically awards currencies to users on daily login, with optional multiplier calculations based on the user's current streak day count.
• [XTR] Credits System Integration: Seamlessly triggers credit transaction events and applies streak multiplier rewards directly to member wallets.

Core System & Architecture​

• Fully engineered for XenForo 2.3.x and PHP 8.0+.
• Zero jQuery dependency: built entirely using XenForo 2.3 Vanilla JavaScript element handlers.
• Session-based deduplication ensures optimal performance with no redundant database queries on repeated page loads.
• Denormalized cached columns on the primary user table for instant widget rendering and postbit displays.
• Native user deletion cleanup integration ensuring zero orphaned database records.
• Localized timezone accuracy respecting individual user language and timezone preferences.
  
  

  Streak Mechanics & Gamification​

• Tracks Current Login Streak, Longest Consecutive Streak, and Total Historical Login Days.
• Configurable daily cutoff hour (0 to 23) for determining when an unrecorded day is marked broken.
• Configurable Streak Freeze grace period (0 to 7 days) to protect active streaks during missed days.
• Automated milestone alert triggers (7, 14, 30, 60, 90, 180, 365, 500, 1000 days and every 100 days thereafter).
• Streak Saved alerts informing users when their streak was preserved by a grace period.
• Web Push notifications for milestones and freeze protections with deep links to account streak pages.
  
  

  Visual Features & Interface​

• Interactive Monthly Calendar with previous/next AJAX navigation.
• GitHub-style 365-day activity heatmap featuring 5 distinct activity level intensity states.
• Heatmap year selector tabs allowing members to browse historical activity across past years.
• Customizable Streak Cycle progress bar (7, 14, 30, or custom days).
• Navigation bar icon trigger with unread badge counter and asynchronous menu loading.
• Postbit / Message user info integration with style property visibility controls.
• Top Streaks Leaderboard widget with configurable display limit.
  
  

  Permissions, Criteria & Customization​

• Comprehensive permission system: View own streak, View others streak, and Use streak freeze grace period.
• User Criteria integration for User Group Promotions, Trophies, and Notices:
  • User has a current daily login streak of at least X days.
  • User has a longest daily login streak of at least X days.
  • User has total login days of at least X days.
• Comprehensive Style Properties group covering fire icon, crown icon, day cell badges, and all 5 heatmap levels.
• Alert opt-out integration allowing members to disable milestone notifications in their personal preferences.
• Complete English phrase coverage for full localization and translation support.
  
  

  Third-Party Add-on Compatibility​

• DragonByte Credits Event Trigger handler with dynamic streak multipliers.
• [XTR] Credits System event integration with automated wallet transaction triggers.