2017 © Pedro Peláez
 

library laravel-activitylog

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

image

spatie/laravel-activitylog

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

  • Saturday, July 28, 2018
  • by Spatie
  • Repository
  • 64 Watchers
  • 1696 Stars
  • 549,411 Installations
  • PHP
  • 46 Dependents
  • 0 Suggesters
  • 250 Forks
  • 10 Open issues
  • 63 Versions
  • 21 % Grown

The README.md

Social Card of Laravel Activity Log, (*1)

Log activity inside your Laravel app

Latest Version on Packagist GitHub Workflow StatusCheck & fix stylingTotal Downloads, (*2)

The spatie/laravel-activitylog package provides easy to use functions to log the activities of the users of your app. It can also automatically log model events. The Package stores all activity in the activity_log table., (*3)

Here's a demo of how you can use it:, (*4)

activity()->log('Look, I logged something');

You can retrieve all activity using the Spatie\Activitylog\Models\Activity model., (*5)

Activity::all();

Here's a more advanced example:, (*6)

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., (*7)

$newsItem->name = 'updated name';
$newsItem->save();

//updating the newsItem will cause the logging of an activity
$activity = Activity::all()->last();

$activity->description; //returns 'updated'
$activity->subject; //returns the instance of NewsItem that was saved

Calling $activity->changes() will return this array:, (*8)

[
   'attributes' => [
        'name' => 'updated name',
        'text' => 'Lorum',
    ],
    'old' => [
        'name' => 'original name',
        'text' => 'Lorum',
    ],
];

Support us

, (*9)

We invest a lot of resources into creating best in class open source packages. You can support us by buying one of our paid products., (*10)

We highly appreciate you sending us a postcard from your hometown, mentioning which of our package(s) you are using. You'll find our address on our contact page. We publish all received postcards on our virtual postcard wall., (*11)

Documentation

You'll find the documentation on https://docs.spatie.be/laravel-activitylog., (*12)

Find yourself stuck using the package? Found a bug? Do you have general questions or suggestions for improving the activity log? Feel free to create an issue on GitHub, we'll try to address it as soon as possible., (*13)

If you've found a security issue please mail freek@spatie.be instead of using the issue tracker., (*14)

Installation

You can install the package via composer:, (*15)

``` bash composer require spatie/laravel-activitylog, (*16)


The package will automatically register itself. You can publish the migration with: ```bash 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., (*17)

After publishing the migration you can create the activity_log table by running the migrations:, (*18)

php artisan migrate

You can optionally publish the config file with:, (*19)

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

This is the contents of the published config file:, (*20)

return [

    /*
     * If set to false, no activities will be saved to the database.
     */
    'enabled' => env('ACTIVITY_LOGGER_ENABLED', true),

    /*
     * When the clean-command is executed, all recording activities older than
     * the number of days specified here will be deleted.
     */
    'delete_records_older_than_days' => 365,

    /*
     * If no log name is passed to the activity() helper
     * we use this default log name.
     */
    'default_log_name' => 'default',

    /*
     * You can specify an auth driver here that gets user models.
     * If this is null we'll use the default Laravel auth driver.
     */
    'default_auth_driver' => null,

    /*
     * If set to true, the subject returns soft deleted models.
     */
    'subject_returns_soft_deleted_models' => false,

    /*
     * This model will be used to log activity.
     * It should be implements the Spatie\Activitylog\Contracts\Activity interface
     * and extend Illuminate\Database\Eloquent\Model.
     */
    'activity_model' => \Spatie\Activitylog\Models\Activity::class,

    /*
     * This is the name of the table that will be created by the migration and
     * used by the Activity model shipped with this package.
     */
    'table_name' => 'activity_log',

     /*
      * This is the database connection that will be used by the migration and
      * the Activity model shipped with this package. In case it's not set
      * Laravel database.default will be used instead.
      */
    'database_connection' => env('ACTIVITY_LOGGER_DB_CONNECTION'),
];

Changelog

Please see CHANGELOG for more information about recent changes., (*21)

Upgrading

Please see UPGRADING for details., (*22)

Testing

bash composer test, (*23)

Contributing

Please see CONTRIBUTING for details., (*24)

Security

If you discover any security related issues, please email freek@spatie.be instead of using the issue tracker., (*25)

Credits

And a special thanks to Caneco for the logo ✨, (*26)

License

The MIT License (MIT). Please see License File for more information., (*27)

The Versions

28/07 2018

dev-master

9999999-dev https://github.com/spatie/activitylog

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

  Sources   Download

MIT

The Requires

 

The Development Requires

laravel log user activity spatie

28/07 2018

dev-analysis-8PaDGm

dev-analysis-8PaDGm https://github.com/spatie/activitylog

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

  Sources   Download

MIT

The Requires

 

The Development Requires

laravel log user activity spatie

28/07 2018

2.8.2

2.8.2.0 https://github.com/spatie/activitylog

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

  Sources   Download

MIT

The Requires

 

The Development Requires

laravel log user activity spatie

28/07 2018

dev-analysis-qMlpPM

dev-analysis-qMlpPM https://github.com/spatie/activitylog

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

  Sources   Download

MIT

The Requires

 

The Development Requires

laravel log user activity spatie

28/07 2018

2.8.1

2.8.1.0 https://github.com/spatie/activitylog

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

  Sources   Download

MIT

The Requires

 

The Development Requires

laravel log user activity spatie

28/07 2018

dev-analysis-8mRMAD

dev-analysis-8mRMAD https://github.com/spatie/activitylog

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

  Sources   Download

MIT

The Requires

 

The Development Requires

laravel log user activity spatie

21/07 2018

2.8.0

2.8.0.0 https://github.com/spatie/activitylog

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

  Sources   Download

MIT

The Requires

 

The Development Requires

laravel log user activity spatie

18/06 2018

2.7.0

2.7.0.0 https://github.com/spatie/activitylog

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

  Sources   Download

MIT

The Requires

 

The Development Requires

laravel log user activity spatie

10/02 2018

2.5.1

2.5.1.0 https://github.com/spatie/activitylog

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

  Sources   Download

MIT

The Requires

 

The Development Requires

laravel log user activity spatie

10/02 2018

2.5.0

2.5.0.0 https://github.com/spatie/activitylog

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

  Sources   Download

MIT

The Requires

 

The Development Requires

laravel log user activity spatie

08/02 2018

2.4.2

2.4.2.0 https://github.com/spatie/activitylog

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

  Sources   Download

MIT

The Requires

 

The Development Requires

laravel log user activity spatie

22/01 2018

2.4.1

2.4.1.0 https://github.com/spatie/activitylog

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

  Sources   Download

MIT

The Requires

 

The Development Requires

laravel log user activity spatie

20/01 2018

2.4.0

2.4.0.0 https://github.com/spatie/activitylog

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

  Sources   Download

MIT

The Requires

 

The Development Requires

laravel log user activity spatie

13/12 2017

2.3.2

2.3.2.0 https://github.com/spatie/activitylog

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

  Sources   Download

MIT

The Requires

 

The Development Requires

laravel log user activity spatie

13/11 2017

2.3.1

2.3.1.0 https://github.com/spatie/activitylog

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

  Sources   Download

MIT

The Requires

 

The Development Requires

laravel log user activity spatie

07/11 2017

2.3.0

2.3.0.0 https://github.com/spatie/activitylog

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

  Sources   Download

MIT

The Requires

 

The Development Requires

laravel log user activity spatie

16/10 2017

2.2.0

2.2.0.0 https://github.com/spatie/activitylog

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

  Sources   Download

MIT

The Requires

 

The Development Requires

laravel log user activity spatie

28/09 2017

dev-analysis-qxMmR9

dev-analysis-qxMmR9 https://github.com/spatie/activitylog

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

  Sources   Download

MIT

The Requires

 

The Development Requires

laravel log user activity spatie

28/09 2017

2.1.2

2.1.2.0 https://github.com/spatie/activitylog

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

  Sources   Download

MIT

The Requires

 

The Development Requires

laravel log user activity spatie

28/09 2017

dev-analysis-8PMLWR

dev-analysis-8PMLWR https://github.com/spatie/activitylog

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

  Sources   Download

MIT

The Requires

 

The Development Requires

laravel log user activity spatie

12/09 2017

2.1.1

2.1.1.0 https://github.com/spatie/activitylog

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

  Sources   Download

MIT

The Requires

 

The Development Requires

laravel log user activity spatie

09/09 2017

2.1.0

2.1.0.0 https://github.com/spatie/activitylog

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

  Sources   Download

MIT

The Requires

 

The Development Requires

laravel log user activity spatie

30/08 2017

2.0.0

2.0.0.0 https://github.com/spatie/activitylog

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

  Sources   Download

MIT

The Requires

 

The Development Requires

laravel log user activity spatie

20/11 2016
11/10 2016
10/10 2016
23/08 2016
17/08 2016

1.7.0

1.7.0.0 https://github.com/spatie/activitylog

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

  Sources   Download

MIT

The Requires

 

The Development Requires

laravel log user activity spatie

11/08 2016

1.6.0

1.6.0.0 https://github.com/spatie/activitylog

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

  Sources   Download

MIT

The Requires

 

The Development Requires

laravel log user activity spatie

11/08 2016

1.5.0

1.5.0.0 https://github.com/spatie/activitylog

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

  Sources   Download

MIT

The Requires

 

The Development Requires

laravel log user activity spatie

10/08 2016

1.4.0

1.4.0.0 https://github.com/spatie/activitylog

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

  Sources   Download

MIT

The Requires

 

The Development Requires

laravel log user activity spatie

09/08 2016

1.3.2

1.3.2.0 https://github.com/spatie/activitylog

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

  Sources   Download

MIT

The Requires

 

The Development Requires

laravel log user activity spatie

09/08 2016

1.3.1

1.3.1.0 https://github.com/spatie/activitylog

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

  Sources   Download

MIT

The Requires

 

The Development Requires

laravel log user activity spatie

29/07 2016

dev-l5.2

dev-l5.2 https://github.com/spatie/activitylog

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

  Sources   Download

MIT

The Requires

 

The Development Requires

laravel log user activity spatie

29/07 2016

1.3.0

1.3.0.0 https://github.com/spatie/activitylog

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

  Sources   Download

MIT

The Requires

 

The Development Requires

laravel log user activity spatie

09/07 2016

1.2.1

1.2.1.0 https://github.com/spatie/activitylog

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

  Sources   Download

MIT

The Requires

 

The Development Requires

laravel log user activity spatie

08/07 2016

1.2.0

1.2.0.0 https://github.com/spatie/activitylog

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

  Sources   Download

MIT

The Requires

 

The Development Requires

laravel log user activity spatie

04/07 2016

1.1.0

1.1.0.0 https://github.com/spatie/activitylog

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

  Sources   Download

MIT

The Requires

 

The Development Requires

laravel log user activity spatie

01/07 2016

1.0.3

1.0.3.0 https://github.com/spatie/activitylog

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

  Sources   Download

MIT

The Requires

 

The Development Requires

laravel log user activity spatie

29/06 2016

1.0.2

1.0.2.0 https://github.com/spatie/activitylog

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

  Sources   Download

MIT

The Requires

 

The Development Requires

laravel log user activity spatie

29/06 2016

1.0.1

1.0.1.0 https://github.com/spatie/activitylog

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

  Sources   Download

MIT

The Requires

 

The Development Requires

laravel log user activity spatie

28/06 2016

1.0.0

1.0.0.0 https://github.com/spatie/activitylog

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

  Sources   Download

MIT

The Requires

 

The Development Requires

laravel log user activity spatie

24/06 2016

0.0.1

0.0.1.0 https://github.com/spatie/activitylog

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

  Sources   Download

MIT

The Requires

 

The Development Requires

laravel log user activity spatie