Download the PHP package wg-vn/laravel-activitylog-ui without Composer

Laravel Activity Log UI

Beautiful, modern UI for Spatie's Activity Log

Important: This package assumes you already have Spatie's Activity Log installed and configured in your Laravel application. It does not replace the logging package—only provides a powerful UI for viewing and analyzing the stored activities.

📖 Documentation

📚 Complete Documentation - Comprehensive guide with advanced features, customization options, and troubleshooting.

✨ Features

• Table, Timeline & Analytics dashboards
• Powerful filter panel (date presets, events, users, subjects, search)
• Saved views, per-page & sorting preferences
• Export to CSV / Excel / PDF / JSON
• Real-time count & pagination powered by Laravel cache
• Authorization gate, middleware & granular access lists
• Tailwind CSS & Alpine.js – no build step required

🗒️ Requirements

• PHP ≥ 8.4
• Laravel 12 | 13
• spatie/laravel-activitylog ≥ 5.0 (already logging your activities)
• paperdoc-dev/paperdoc-lib ^1.1 (Excel & PDF exports)
• Database table activity_log with Spatie v5’s schema (includes attribute_changes column)

On Laravel 12 Composer resolves spatie/laravel-activitylog to 5.0.0, because 5.1.0 requires illuminate/* ^13.0. The schema and everything in this package behave the same on both; you are simply pinned to 5.0.x until you move to Laravel 13. Verified against Laravel 12.66 / Spatie 5.0.0 and Laravel 13.25 / Spatie 5.1.0.

🚀 Installation

1. Install the package

2. (Optional) Publish resources

3. Run migrations
   Ensure you have already run Spatie’s migrations so the activity_log table exists:

4. (Recommended on a large log) Add the UI’s indexes
   Spatie indexes the log for lookups by subject and causer. This UI lists everything newest first, which nothing indexes — on a log of 200,000 rows MySQL answers a single page by reading every row and sorting the lot.

   Measured on 204,963 activities, this took the first page from 350 ms to 21 ms and let the analytics queries read an index instead of the table. It is a separate step because activity_log is Spatie’s table and because building an index on an established log locks it while it runs — about a second at that size, longer on a bigger one.

5. Visit the UI

⚙️ Configuration Overview

A full configuration file is published to config/activitylog-ui.php. Below is a quick reference:

Refer to the inline comments in the file for every available option.

🗄️ Custom Table or Connection

Spatie v5 removed the activitylog.table_name and activitylog.database_connection settings. The supported way to move the log is a custom Activity model:

This UI reads that model's table and connection, so it follows the log wherever you put it — no additional configuration here. Note it reads the location, not the model itself: scopes, casts and accessors you add to your model are not used by the UI's queries.

🔐 Authorization & Access Control

Access is decided in this order:

1. authorization.enabled (default true, or ACTIVITYLOG_UI_AUTHORIZATION) — requires a logged-in user, then the gate below. Turning it off removes the login requirement.
2. access.allowed_users / access.allowed_roles — if either is non-empty it is enforced regardless of step 1, so an allow-list still requires a matching logged-in user even with authorization disabled.
3. With authorization off and both lists empty, the UI is fully public: anyone who can reach the URL can read who did what, when, and to which record. That combination is for local development only.

Notes:

• Gate: viewActivityLogUi is auto-registered (see ActivitylogUiServiceProvider). By default it allows any authenticated user and narrows to the lists above once you set them. Define your own to replace that logic.
• Roles use hasAnyRole() or hasRole() if your user model provides them (Spatie Permission and similar). Without either method, a user cannot match a role and is denied.
• route.middleware replaces the base stack (['web']) only. Authentication and the access middleware are appended afterwards and cannot be removed by it.
• Requires a named login route when authorization is on and a guest opens the UI in a browser — that is Laravel's auth middleware redirect. Apps without auth scaffolding should configure redirectGuestsTo() or leave authorization off. JSON requests get a 401 instead.

📤 Exports

• CSV / Excel (XLSX) / PDF / JSON all work out-of-the-box, powered by paperdoc-dev/paperdoc-lib.
• Large exports can be queued; enable exports.queue.enabled.

📈 Analytics Dashboard

Enable/disable with features.analytics. Caches stats for analytics.cache_duration seconds (default 1 h).

🤝 Contributing

PRs and issues are welcome!

📝 License

The MIT License (MIT). See LICENSE for details.