jansuchanek/npresence

Live user presence, heartbeat tracking, and activity logging for Nette Framework

v1.0.0 2026-03-19 08:33 UTC

Requires

• php: >=8.1
• doctrine/dbal: ^3.0|^4.0

Requires (Dev)

• nette/di: ^3.2
• nette/tester: ^2.6

MIT

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