[Feature Request] Dispatch an event when touchLastSeen

[chrisvidal]

Is it possible to add an event when a user is authenticated on the platform when the touchLastSeen method is called please ?

My requirement is to keep streaks of users presence on the platform.
Since the platform does not logout the frontend user, the user session is alive all the time.
Therefore, I am thinking of using the method touchLastSeen to record and store the history of the user presence.

thank you in advance

[apinard]

Hey @chrisvidal,

I'm wondering if touchLastSeen actually gets called when there's no active logging happening. Have you considered using a component in your layout instead?

<?php namespace YourName\UserTracker\Components;

use Cms\Classes\ComponentBase;
use Auth;
use Cache;
use Carbon\Carbon;

class UserActivity extends ComponentBase
{
    public function onRun()
    {
        if ($user = Auth::getUser()) {
            $this->trackUserActivity($user);
        }
    }
    
    protected function trackUserActivity($user)
    {
        $today = Carbon::now()->toDateString();
        $cacheKey = "user_activity_{$user->id}_{$today}";
        
        // Only track once per day per user (performance optimization)
        if (!Cache::get($cacheKey)) {
            // Touch last seen (your requirement)
            $user->touchLastSeen();
            
            // Update streak
            $this->updateStreak($user, $today);
            
            // Cache until end of day
            $minutesUntilMidnight = Carbon::now()->endOfDay()->diffInMinutes();
            Cache::put($cacheKey, true, $minutesUntilMidnight);
        }
    }
    
    protected function updateStreak($user, $date)
    {
        $streak = UserStreak::firstOrCreate(['user_id' => $user->id]);
        
        if (!$streak->last_activity_date) {
            // First activity
            $streak->current_streak = 1;
            $streak->longest_streak = 1;
        } else {
            $lastDate = Carbon::parse($streak->last_activity_date);
            $currentDate = Carbon::parse($date);
            $daysDiff = $lastDate->diffInDays($currentDate);
            
            if ($daysDiff === 1) {
                // Consecutive day - increment streak
                $streak->current_streak++;
                if ($streak->current_streak > $streak->longest_streak) {
                    $streak->longest_streak = $streak->current_streak;
                }
            } elseif ($daysDiff > 1) {
                // Streak broken - reset
                $streak->current_streak = 1;
            }
            // Same day = no change
        }
        
        $streak->last_activity_date = $date;
        $streak->save();
    }
}

[chrisvidal]

Thanks @apinard for your code, it's indeed a great way to handle this streak.

from what I understand in the existing session component, it is it who triggers the touchLastSeen on user.

here

public function onRun()
    {
        if ($redirect = $this->checkUserSecurityRedirect()) {
            return $redirect;
        }

        $this->page['user'] = $this->user();
    }

/**
     * user returns the logged in user
     */
    public function user(): ?User
    {
        $user = Auth::user();

        if ($user && !Auth::isImpersonator()) {
            $user->touchLastSeen();
        }

        return $user;
    }

that means that everytime a page containing the session component is rendered to the frontend, it will trigger the method lastTouchSeen on the user. But maybe I am missing something and it does not work like that.

[apinard]

Maybe the generic "model.afterFetch" event would be enough ?

[chrisvidal]

Maybe, but without an specific event, I'd prefer your component solution.