PHPackages                             heccubernny/activity-tracker - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. heccubernny/activity-tracker

ActiveLibrary[Utility & Helpers](/categories/utility)

heccubernny/activity-tracker
============================

A lightweight Laravel package to track user and model activities

v1.0.2(9mo ago)02MITPHPPHP >=8.0

Since Sep 20Pushed 9mo agoCompare

[ Source](https://github.com/Heccubernny/laravel-user-activity-tracker)[ Packagist](https://packagist.org/packages/heccubernny/activity-tracker)[ RSS](/packages/heccubernny-activity-tracker/feed)WikiDiscussions main Synced today

READMEChangelogDependencies (1)Versions (4)Used By (0)

Laravel User Activity Tracker
=============================

[](#laravel-user-activity-tracker)

> ⚠️ **Note:** This package is currently in development and not yet production-ready. Some bugs and issues may still exist. Use at your own risk.

A lightweight Laravel package to track user and model activities for web and API applications.

This package allows you to automatically track model events (created, updated, deleted) and route visits, as well as manually log custom activities. It supports both **JWT-based API authentication** and **web session authentication**.

---

Installation
------------

[](#installation)

Install via Composer:

```
composer require heccubernny/activity-tracker
```

Publish configuration and migrations:

```
php artisan vendor:publish --provider="Heccubernny\ActivityTracker\ActivityServiceProvider" --tag="activitytracker-config"

php artisan vendor:publish --provider="Heccubernny\ActivityTracker\ActivityServiceProvider" --tag="activitytracker-migrations"

php artisan migrate
```

Middleware Setup
----------------

[](#middleware-setup)

Register the middleware in `app/Http/Kernel.php`:

```
protected $routeMiddleware = [
    // ...
    'activity.log' => \Heccubernny\ActivityTracker\Middleware\LogRouteActivity::class,
];
```

Apply middleware to routes:

```
Route::get('/dashboard', function () {
    // ...
})->middleware('activity.log:visited-dashboard');
```

You can optionally pass a subject (model) to associate with the activity:

```
Route::get('/posts/{post}', function (App\Models\Post $post) {
    // ...
})->middleware(\Heccubernny\ActivityTracker\Middleware\LogRouteActivity::class.':view-post,' . $post->id);
```

Automatic Model Logging
-----------------------

[](#automatic-model-logging)

Add the `LogsActivity` trait to any model you want to track:

```
use Heccubernny\ActivityTracker\Traits\LogsActivity;

class Post extends Model
{
    use LogsActivity;
}
```

By default, it tracks:

- created
- updated
- deleted

and logs:

- subject\_id
- subject\_type
- user\_id
- user\_type
- description
- properties (full model attributes)
- ip\_address, url, method, agent

Manual Logging
--------------

[](#manual-logging)

Use the `activity()` facade for custom events:

```
activity()->log([
    'name' => 'exported-report',
    'description' => 'User exported the monthly sales report',
    'properties' => ['report' => 'monthly-sales'],
    // Optional: user_id, user_type, subject_id, subject_type
]);
```

or directly on a model

```
$post->logActivity('published', ['description' => 'Published via admin panel']);
```

Configuration (Optional)
------------------------

[](#configuration-optional)

You can set the activity retention in your `.env`:

```
ACTIVITY_RETENTION_DAYS=null
```

- `null` keeps logs forever.
- Set to a number of days to automatically purge old logs.

Example Usage
-------------

[](#example-usage)

Manual logging:

```
activity()->log([
    'name' => 'exported-report',
    'description' => 'User exported the monthly sales report',
    'properties' => ['report' => 'monthly-sales'],
]);
```

Automatic model logging:

```
$post = Post::find(1);
$post->logActivity('published', ['description' => 'Published via admin panel']);
```

Route-based logging:

```
Route::get('/dashboard', function () {
    // ...
})->middleware('activity.log:visited-dashboard');
```

### Credits

[](#credits)

Special thanks to [Nuno Maduro](https://github.com/nunomaduro) for his [dry repository](https://github.com/nunomaduro/dry) it was the skeleton inspiration.

License: MIT

###  Health Score

29

—

LowBetter than 57% of packages

Maintenance57

Moderate activity, may be stable

Popularity2

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity43

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~0 days

Total

3

Last Release

286d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/42838142?v=4)[Paul Oladayo](/maintainers/heccubernny)[@Heccubernny](https://github.com/Heccubernny)

---

Top Contributors

[![Heccubernny](https://avatars.githubusercontent.com/u/42838142?v=4)](https://github.com/Heccubernny "Heccubernny (3 commits)")

### Embed Badge

![Health badge](/badges/heccubernny-activity-tracker/health.svg)

```
[![Health](https://phpackages.com/badges/heccubernny-activity-tracker/health.svg)](https://phpackages.com/packages/heccubernny-activity-tracker)
```

###  Alternatives

[psalm/plugin-laravel

Psalm plugin for Laravel

3355.3M346](/packages/psalm-plugin-laravel)[renatomarinho/laravel-page-speed

Laravel Page Speed

2.5k1.7M11](/packages/renatomarinho-laravel-page-speed)[illuminate/pagination

The Illuminate Pagination package.

12234.1M1.0k](/packages/illuminate-pagination)[illuminate/pipeline

The Illuminate Pipeline package.

9349.2M282](/packages/illuminate-pipeline)[illuminate/redis

The Illuminate Redis package.

8314.6M375](/packages/illuminate-redis)[illuminate/cookie

The Illuminate Cookie package.

244.6M136](/packages/illuminate-cookie)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)