A backport of Spatie's Laravel-ActivityLog
This is a backport package that allows Laravel-ActivityLog to work with PHP 5.6. By design the namespace of the original project has been left untouched Spatie\Activitylog. This allows for full use of the documentation with only minor modifications:, (*1)
Installation
Change
``` bash
composer require spatie/laravel-activitylog, (*2)
to
``` bash
composer require linearsoft/laravel-activitylog-backport
For your convenience the Activity facade infrastructure has been restored in this backport.
All you need to do is register the facade:, (*3)
// config/app.php
'aliases' => [
...
'Activity' => Spatie\Activitylog\ActivitylogFacade::class,
];
Testing
All testing has been stripped from the backport version., (*4)
Bugs or features requests
For the most part most all bugs & requests should be submitted to the Spatie Team. And the fixes/features will eventually be backported into this project., (*5)
If, however, you found a problem specifically with the backport version please it via GitHub, (*6)
Licensing
The licensing has been modified from MIT to the GPLv3 License - see the LICENSE file for details.
You are requested, however, to still follow the Postcardware "requirements" of the original package., (*7)
START OF ORIGINAL ReadMe.md
Log activity inside your Laravel app
The spatie/laravel-activity package provides easy to use functions to log the activities of the users of your app. It can also automatically log model events. All activity will be stored in the activity_log table., (*8)
Here's a litte demo of how you can use it:, (*9)
activity()->log('Look, I logged something');
You can retrieve all activity using the Spatie\Activitylog\Models\Activity model., (*10)
Activity::all();
Here's a more advanced example:, (*11)
activity()
->performedOn($anEloquentModel)
->causedBy($user)
->withProperties(['customProperty' => 'customValue'])
->log('Look, I logged something');
$lastLoggedActivity = Activity::all()->last();
$lastLoggedActivity->subject; //returns an instance of an eloquent model
$lastLoggedActivity->causer; //returns an instance of your user model
$lastLoggedActivity->getExtraProperty('customProperty'); //returns 'customValue'
$lastLoggedActivity->description; //returns 'Look, I logged something'
Here's an example on event logging., (*12)
$newsItem->name = 'updated name';
$newsItem->save();
//updating the newsItem will cause an activity being logged
$activity = Activity::all()->last();
$activity->description; //returns 'updated'
$activity->subject; //returns the instance of NewsItem that was created
Calling $activity->changes will return this array:, (*13)
[
'attributes' => [
'name' => 'updated name',
'text' => 'Lorum',
],
'old' => [
'name' => 'original name',
'text' => 'Lorum',
],
];
Spatie is a webdesign agency based in Antwerp, Belgium. You'll find an overview of all our open source projects on our website., (*14)
Postcardware
You're free to use this package ~~(it's MIT-licensed)~~, but if it makes it to your production environment you are required to send us a postcard from your hometown, mentioning which of our package(s) you are using., (*15)
Our address is: Spatie, Samberstraat 69D, 2060 Antwerp, Belgium., (*16)
The best postcards will get published on the open source page on our website., (*17)
Documentation
You'll find the documentation on https://docs.spatie.be/laravel-activitylog/v1., (*18)
Find yourself stuck using the package? Found a bug? Do you have general questions or suggestions for improving the media library? Feel free to create an issue on GitHub, we'll try to address it as soon as possible., (*19)
If you've found a bug regarding security please mail freek@spatie.be instead of using the issue tracker., (*20)
Installation
You can install the package via composer:, (*21)
``` bash
composer require spatie/laravel-activitylog, (*22)
Next, you must install the service provider:
```php
// config/app.php
'providers' => [
...
Spatie\Activitylog\ActivitylogServiceProvider::class,
];
You can publish the migration with:, (*23)
php artisan vendor:publish --provider="Spatie\Activitylog\ActivitylogServiceProvider" --tag="migrations"
Note: The default migration assumes you are using integers for your model IDs. If you are using UUIDs, or some other format, adjust the format of the subject_id and causer_id fields in the published migration before continuing., (*24)
After the migration has been published you can create the activity_log table by running the migrations:, (*25)
php artisan migrate
You can optionally publish the config file with:, (*26)
php artisan vendor:publish --provider="Spatie\Activitylog\ActivitylogServiceProvider" --tag="config"
This is the contents of the published config file:, (*27)
return [
/**
* When set to false, no activities will be saved to database.
*/
'enabled' => env('ACTIVITY_LOGGER_ENABLED', true),
/**
* When running the clean-command all recording activites older than
* the number of days specified here will be deleted.
*/
'delete_records_older_than_days' => 365,
/**
* When not specifying a log name when logging activity
* we'll using this log name.
*/
'default_log_name' => 'default',
/**
* When set to true, the subject returns soft deleted models.
*/
'subject_returns_soft_deleted_models' => false,
/**
* This model will be used to log activity. The only requirement is that
* it should be or extend the Spatie\Activitylog\Models\Activity model.
*/
'activity_model' => \Spatie\Activitylog\Models\Activity::class,
];
Changelog
Please see CHANGELOG for more information what has changed recently., (*28)
Testing
bash
$ composer test, (*29)
Contributing
Please see CONTRIBUTING for details., (*30)
Security
If you discover any security related issues, please email freek@spatie.be instead of using the issue tracker., (*31)
Credits
About Spatie
Spatie is a webdesign agency based in Antwerp, Belgium. You'll find an overview of all our open source projects on our website., (*32)
License
~~The MIT License (MIT). Please see License File for more information~~., (*33)
Wallogit.com
