README

User presence tracking for Nette applications — heartbeats, active sessions, activity logging, browser detection.

Installation

composer require jansuchanek/npresence

Nette Integration

extensions:
    presence: NPresence\PresenceExtension

presence:
    staleMinutes: 5  # optional, default 5

Usage

In Presenter (heartbeat endpoint)

use NPresence\PresencePresenterTrait;

class SecurityPresenter extends BasePresenter
{
    use PresencePresenterTrait;
}

Service API

use NPresence\PresenceService;

$service->heartbeat($userId, $sessionId, $userAgent);
$activeSessions = $service->getActiveSessions();
$service->logActivity($userId, 'login', $request);
$service->cleanupStaleSessions();

Requirements

• PHP >= 8.1
• doctrine/dbal