A very simple activity logger to monitor the users of your website or application

#Laravel Activity Log Package Summary

The spatie/laravel-activitylog package is a robust tool designed to help developers log activities within their Laravel applications effortlessly. It offers a straightforward approach to tracking user interactions and system events, making it invaluable for auditing and monitoring purposes.

#Key Features

• Simple Logging: Quickly log activities with a minimal setup.
• Eloquent Model Tracking: Automatically log events related to model changes.
• Retrieval of Logs: Easily access logs using the Activity model.
• Flexible Log Contexts: Enhance logs with custom properties, models, and causes.
• Automatic Event Logging: Effortlessly log model events like create, update, and delete actions.

#Installation and Setup

To get started with spatie/laravel-activitylog, you can install it via Composer:

composer require spatie/laravel-activitylog

After installation, publish and run the migrations:

php artisan vendor:publish --provider="Spatie\Activitylog\ActivitylogServiceProvider" --tag="activitylog-migrations"
php artisan migrate

Optionally, you can publish the configuration file for further customization:

php artisan vendor:publish --provider="Spatie\Activitylog\ActivitylogServiceProvider" --tag="activitylog-config"

#Usage

Logging activity is as simple as:

activity()->log('Log message');

For more advanced usage, such as logging actions performed on an eloquent model by a specific user, you can chain methods like so:

activity()
   ->performedOn($model)
   ->causedBy($user)
   ->log('Performed an action');

You can retrieve and inspect logged activities using:

$activity = Activity::all()->last();

#Documentation and Support

Full documentation is available here, providing detailed instructions and advanced usage scenarios. For issues and feature requests, create an issue on GitHub.

#Contributions and Security

Contributions are welcome, and for security issues, please email security@spatie.be directly.

#License

The package is open-sourced under the MIT license, making it available for personal and commercial use.

In summary, the spatie/laravel-activitylog package is an essential tool for developers needing efficient and effective activity logging in Laravel applications, providing powerful features with minimal setup.