CasperSecurity
# Changelog
All notable changes to `spatie/laravel-activitylog` will be documented in this file
## 4.10.1 - 2025-02-10
### What's Changed
* Laravel 12.x Support by @erikn69 in https://github.com/spatie/laravel-activitylog/pull/1370
**Full Changelog**: https://github.com/spatie/laravel-activitylog/compare/4.10.0...4.10.1
## 4.10.0 - 2025-02-10
### What's Changed
* Bump stefanzweifel/git-auto-commit-action from 5.0.1 to 5.1.0 by @dependabot in https://github.com/spatie/laravel-activitylog/pull/1365
* Bump actions/stale from 9.0.0 to 9.1.0 by @dependabot in https://github.com/spatie/laravel-activitylog/pull/1367
* Bump dependabot/fetch-metadata from 2.2.0 to 2.3.0 by @dependabot in https://github.com/spatie/laravel-activitylog/pull/1368
* Activity Facade by @stevebauman in https://github.com/spatie/laravel-activitylog/pull/1372
**Full Changelog**: https://github.com/spatie/laravel-activitylog/compare/4.9.1...4.10.0
## 4.9.1 - 2024-11-18
### What's Changed
* Update using-multiple-logs.md by @tobischulz in https://github.com/spatie/laravel-activitylog/pull/1345
* fix: php 8.4 deprecation warnings by @ashleyshenton in https://github.com/spatie/laravel-activitylog/pull/1351
### New Contributors
* @tobischulz made their first contribution in https://github.com/spatie/laravel-activitylog/pull/1345
* @ashleyshenton made their first contribution in https://github.com/spatie/laravel-activitylog/pull/1351
**Full Changelog**: https://github.com/spatie/laravel-activitylog/compare/4.9.0...4.9.1
## 4.9.0 - 2024-10-18
### What's Changed
* Bump dependabot/fetch-metadata from 1.6.0 to 2.1.0 by @dependabot in https://github.com/spatie/laravel-activitylog/pull/1298
* Bump stefanzweifel/git-auto-commit-action from 4.15.4 to 5.0.1 by @dependabot in https://github.com/spatie/laravel-activitylog/pull/1293
* Corrected the link to the event logging example by @makaronnik in https://github.com/spatie/laravel-activitylog/pull/1300
* Bump dependabot/fetch-metadata from 2.1.0 to 2.2.0 by @dependabot in https://github.com/spatie/laravel-activitylog/pull/1315
* Update batch-logs.md by @jesseschutt in https://github.com/spatie/laravel-activitylog/pull/1320
* Adjust PHPDoc type for causer and subject by @gtg-bantonio in https://github.com/spatie/laravel-activitylog/pull/1321
* Add missing return type by @dwightwatson in https://github.com/spatie/laravel-activitylog/pull/1330
* Possibility to define table name in environment file by @edwinvdpol in https://github.com/spatie/laravel-activitylog/pull/1334
### New Contributors
* @makaronnik made their first contribution in https://github.com/spatie/laravel-activitylog/pull/1300
* @jesseschutt made their first contribution in https://github.com/spatie/laravel-activitylog/pull/1320
* @gtg-bantonio made their first contribution in https://github.com/spatie/laravel-activitylog/pull/1321
* @edwinvdpol made their first contribution in https://github.com/spatie/laravel-activitylog/pull/1334
**Full Changelog**: https://github.com/spatie/laravel-activitylog/compare/4.8.0...4.9.0
## 4.8.0 - 2024-03-08
### What's Changed
* Bump dependabot/fetch-metadata from 1.3.6 to 1.4.0 by @dependabot in https://github.com/spatie/laravel-activitylog/pull/1183
* Bump dependabot/fetch-metadata from 1.4.0 to 1.5.0 by @dependabot in https://github.com/spatie/laravel-activitylog/pull/1195
* Bump dependabot/fetch-metadata from 1.5.0 to 1.5.1 by @dependabot in https://github.com/spatie/laravel-activitylog/pull/1196
* Bump dependabot/fetch-metadata from 1.5.1 to 1.6.0 by @dependabot in https://github.com/spatie/laravel-activitylog/pull/1205
* Add a missing apostrophe by @dwightwatson in https://github.com/spatie/laravel-activitylog/pull/1249
* Bump actions/stale from 6.0.1 to 9.0.0 by @dependabot in https://github.com/spatie/laravel-activitylog/pull/1250
* Bump actions/cache from 3 to 4 by @dependabot in https://github.com/spatie/laravel-activitylog/pull/1263
* Add more detail to manipulating changes by @tonypartridge in https://github.com/spatie/laravel-activitylog/pull/1268
* feat!: add laravel 11 support by @StevePorter92 in https://github.com/spatie/laravel-activitylog/pull/1276
### New Contributors
* @dwightwatson made their first contribution in https://github.com/spatie/laravel-activitylog/pull/1249
* @tonypartridge made their first contribution in https://github.com/spatie/laravel-activitylog/pull/1268
* @StevePorter92 made their first contribution in https://github.com/spatie/laravel-activitylog/pull/1276
**Full Changelog**: https://github.com/spatie/laravel-activitylog/compare/4.7.3...4.8.0
## 4.7.3 - 2023-01-25
### What's Changed
- Add Dependabot Automation by @patinthehat in https://github.com/spatie/laravel-activitylog/pull/1128
- Add PHP 8.2 Support by @patinthehat in https://github.com/spatie/laravel-activitylog/pull/1129
- Bump dependabot/fetch-metadata from 1.3.5 to 1.3.6 by @dependabot in https://github.com/spatie/laravel-activitylog/pull/1156
- Fix tests badge by @erikn69 in https://github.com/spatie/laravel-activitylog/pull/1153
- Laravel 10.x support by @erikn69 in https://github.com/spatie/laravel-activitylog/pull/1152
- Fix for replacePlaceholders with ending dot by @Stefan-Dressler in https://github.com/spatie/laravel-activitylog/pull/1154
### New Contributors
- @patinthehat made their first contribution in https://github.com/spatie/laravel-activitylog/pull/1128
- @erikn69 made their first contribution in https://github.com/spatie/laravel-activitylog/pull/1153
- @Stefan-Dressler made their first contribution in https://github.com/spatie/laravel-activitylog/pull/1154
**Full Changelog**: https://github.com/spatie/laravel-activitylog/compare/4.7.2...4.7.3
## v4.7.2 - 2022-11-14
### What's Changed
- Bump actions/checkout from 2 to 3 by @dependabot in https://github.com/spatie/laravel-activitylog/pull/1117
- Bump actions/stale from 2.0.0 to 6.0.1 by @dependabot in https://github.com/spatie/laravel-activitylog/pull/1118
- Bump stefanzweifel/git-auto-commit-action from 4.0.0 to 4.15.4 by @dependabot in https://github.com/spatie/laravel-activitylog/pull/1119
- Add missing properties to Activity model by @AndreasHerss in https://github.com/spatie/laravel-activitylog/pull/1101
- Bump actions/cache from 2 to 3 by @dependabot in https://github.com/spatie/laravel-activitylog/pull/1120
- Fix enum casting by @Gummibeer in https://github.com/spatie/laravel-activitylog/pull/1121
### New Contributors
- @dependabot made their first contribution in https://github.com/spatie/laravel-activitylog/pull/1117
- @AndreasHerss made their first contribution in https://github.com/spatie/laravel-activitylog/pull/1101
**Full Changelog**: https://github.com/spatie/laravel-activitylog/compare/4.7.1...4.7.2
## v4.7.1 - 2022-11-11
### What's Changed
- Fix nullable custom properties in PHP 8.0 by @stevebauman in https://github.com/spatie/laravel-activitylog/pull/1115
**Full Changelog**: https://github.com/spatie/laravel-activitylog/compare/4.7.0...4.7.1
## v4.7.0 - 2022-11-10
### What's Changed
- Fix indentation by @mouadziani in https://github.com/spatie/laravel-activitylog/pull/1092
- Support non backed enum & php 8.1 by @pemudakoding in https://github.com/spatie/laravel-activitylog/pull/1110
### New Contributors
- @mouadziani made their first contribution in https://github.com/spatie/laravel-activitylog/pull/1092
- @pemudakoding made their first contribution in https://github.com/spatie/laravel-activitylog/pull/1110
**Full Changelog**: https://github.com/spatie/laravel-activitylog/compare/4.6.0...4.7.0
## v4.6.0 - 2022-09-22
### What's Changed
- Add a default value to `getExtraProperty()` by @grantholle in https://github.com/spatie/laravel-activitylog/pull/1090
### New Contributors
- @grantholle made their first contribution in https://github.com/spatie/laravel-activitylog/pull/1090
**Full Changelog**: https://github.com/spatie/laravel-activitylog/compare/4.5.3...4.6.0
## 4.5.3 - 2022-05-31
- Fix default auth guard for causer - [#1053](https://github.com/spatie/laravel-activitylog/pull/1053)
## 4.5.2 - 2022-04-21
- Fix placeholder resolving - [#1038](https://github.com/spatie/laravel-activitylog/pull/1038)
## 4.5.1 - 2022-04-07
- [Use scoped instances of instead of singletons (Octane support)](https://github.com/spatie/laravel-activitylog/commit/0d0075b9c56ed0c282f59037e71cdaa6a052d336)
**Full Changelog**: https://github.com/spatie/laravel-activitylog/compare/4.5.0...4.5.1
## 4.5.0 - 2022-04-07
## What's Changed
- Add `Conditionable` trait to `ActivityLogger` by @usernotnull in https://github.com/spatie/laravel-activitylog/pull/997
## New Contributors
- @usernotnull made their first contribution in https://github.com/spatie/laravel-activitylog/pull/997
**Full Changelog**: https://github.com/spatie/laravel-activitylog/compare/4.4.3...4.5.0
## 4.4.3 - 2022-04-07
## What's Changed
- Fix model serialization when using `LogsActivity` with `setDescriptionForEvent()` by @stevebauman in https://github.com/spatie/laravel-activitylog/pull/977
- Fix activirt logging on model restore (#895) by @kryptamine in https://github.com/spatie/laravel-activitylog/pull/1000
- Fix nullable log names by @stevebauman in https://github.com/spatie/laravel-activitylog/pull/1029
- Fix `tapActivity` when manually creating activity logs by @FrancisMawn in https://github.com/spatie/laravel-activitylog/pull/1031
## New Contributors
- @stevebauman made their first contribution in https://github.com/spatie/laravel-activitylog/pull/977
- @kryptamine made their first contribution in https://github.com/spatie/laravel-activitylog/pull/1000
- @FrancisMawn made their first contribution in https://github.com/spatie/laravel-activitylog/pull/1031
**Full Changelog**: https://github.com/spatie/laravel-activitylog/compare/4.4.2...4.4.3
## 4.4.2 - 2022-03-07
- [#1018](https://github.com/spatie/laravel-activitylog/pull/1018)
## 4.4.1 - 2022-03-04
- https://github.com/spatie/laravel-activitylog/pull/956
## 4.4.0 - 2022-01-12
- allow Laravel 9
## 4.3.1 - 2021-10-20
- Fix hardcoded `deleted_at` column usage - [#965](https://github.com/spatie/laravel-activitylog/issues/965)
## 4.3.0 - 2021-10-20
- Add `\Spatie\Activitylog\LogOptions::useAttributeRawValues()` to log uncasted attributes - [#972](https://github.com/spatie/laravel-activitylog/issues/972)
## 4.2.0 - 2021-10-06
- Add `immutable_date` cast support - [#969](https://github.com/spatie/laravel-activitylog/issues/969)
## 4.1.1 - 2021-07-23
- Fix migration stub names - [#914](https://github.com/spatie/laravel-activitylog/issues/914)
## 4.1.0 - 2021-07-23
- Add `\Spatie\Activitylog\LogBatch::setBatch(string $uuid)` method to keep batches across requests or multiple jobs - [#918](https://github.com/spatie/laravel-activitylog/issues/918)
## 4.0.0 - 2021-05-04
PR: [#787](https://github.com/spatie/laravel-activitylog/pull/787)
Special thanks to [Ahmed Nagi](https://github.com/nagi1).
- Drop Laravel 6 and 7 support.
- Drop PHP 7.x support.
- Add `LogOptions` configuration object to replace all configuration properties.
- Add ability to batch activity logs [#560](https://github.com/spatie/laravel-activitylog/issues/560)
- Add Pipeline to customize logged changes data.
- - Deep diff array/JSON sub-keys and respect for only-dirty, no-empty ... [#692](https://github.com/spatie/laravel-activitylog/issues/692) using new pipeline. See implementation in the tests.
-
-
-
-
-
-
-
-
-
-
-
- Implement a `CauserResolver` to define causer for current runtime [#582](https://github.com/spatie/laravel-activitylog/issues/582).
## 3.17.0 - 2021-03-02
- drop PHP 7.2 support - [#855](https://github.com/spatie/laravel-activitylog/pull/855)
## 3.16.1 - 2020-11-03
- add PHP 8.0 support - [#806](https://github.com/spatie/laravel-activitylog/pull/806)
## 3.16.0 - 2020-09-16
- use `nullableMorphs()` in default migration - [#707](https://github.com/spatie/laravel-activitylog/pull/707)
- add support for snake and camel cased related model attribute logging - [#721](https://github.com/spatie/laravel-activitylog/pull/721)
## 3.15.0 - 2020-09-14
- Add multiple/chained relation attribute logging support - [#784](https://github.com/spatie/laravel-activitylog/pull/784)
## 3.14.3 - 2020-09-09
- Add support for Laravel 8
## 3.14.2 - 2020-05-19
- fix `retrieved` event logging
## 3.14.1 - 2020-03-23
- revert breaking changes in `v3.14.0`
## 3.14.0 - 2020-03-23 - BC
Please use `v3.14.1` instead - this release is breaking because of the new column. There is also a `v4.0.0-rc.1` release that equals to this one.
- add `\Spatie\Activitylog\ActivityLogger::event()` method and column [#702](https://github.com/spatie/laravel-activitylog/pull/702)
## 3.13.0 - 2020-03-13
- add `\Spatie\Activitylog\ActivityLogger::withoutLogs()` method [#695](https://github.com/spatie/laravel-activitylog/pull/695)
## 3.12.0 - 2020-03-13
- respect custom date casts [#627](https://github.com/spatie/laravel-activitylog/pull/627)
## 3.11.4 - 2020-03-11
- remove `spatie/string` dependency [#690](https://github.com/spatie/laravel-activitylog/pull/690)
## 3.11.3 - 2020-03-10
- fix performance issue around global vs model log disabling [#682](https://github.com/spatie/laravel-activitylog/pull/682)
## 3.11.2 - 2020-03-10
- fix Laravel 7 array/json casted attributes [#680](https://github.com/spatie/laravel-activitylog/pull/680)
## 3.11.1 - 2020-03-02
- fix requirements
## 3.11.0 - 2020-03-02
- add support for Laravel 7
## 3.10.0 - 2020-02-22
- add ability to manually set created at date - [#622](https://github.com/spatie/laravel-activitylog/pull/622)
## 3.9.2 - 2020-02-04
- drop support for Laravel 5
## 3.9.1 - 2019-10-15
- fix default database connection - [#616](https://github.com/spatie/laravel-activitylog/pull/616)
## 3.9.0 - 2019-10-06
- add anonymous causer with `null` value - [#605](https://github.com/spatie/laravel-activitylog/pull/605)
- fix relationships to allow snake case keys - [#602](https://github.com/spatie/laravel-activitylog/pull/602)
- add JOSN sub-key attribute logging - [#601](https://github.com/spatie/laravel-activitylog/pull/601)
## 3.8.0 - 2019-09-04
- add support for Laravel 6
- change fields with value `null` to be strictly compared when logging dirty fields [#453](https://github.com/spatie/laravel-activitylog/pull/453)
- add composite indexes for subject and causer to migration
## 3.7.2 - 2019-08-28
- do not export docs folder
## 3.7.1 - 2019-07-24
- fix default database connection env var
## 3.7.0 - 2019-07-23
- add database connection to configuration `activitylog.database_connection` and `ACTIVITY_LOGGER_DB_CONNECTION` env var [#568](https://github.com/spatie/laravel-activitylog/pull/568)
## 3.6.3 - 2019-07-23
- fix deprecated `array_` helper [#569](https://github.com/spatie/laravel-activitylog/pull/569)
## 3.6.2 - 2019-07-16
- fix existing description [#563](https://github.com/spatie/laravel-activitylog/pull/563)
## 3.6.1 - 2019-05-29
- fix nullable date attributes [#546](https://github.com/spatie/laravel-activitylog/pull/546)
## 3.6.0 - 2019-05-28
- update `properties` column type from `text` to `json` [#525](https://github.com/spatie/laravel-activitylog/pull/525)
- update `subject_id` and `causer_id` column type from `integer` to `big_integer` and `unsigned` [#527](https://github.com/spatie/laravel-activitylog/pull/527)
- fix attribute getter support in `DetectsChanges` trait [#534](https://github.com/spatie/laravel-activitylog/pull/534)
- fix old attributes retrieval in `DetectsChanges` trait [#537](https://github.com/spatie/laravel-activitylog/pull/537)
- clean up old attributes in `DetectsChanges` trait [#538](https://github.com/spatie/laravel-activitylog/pull/538)
## 3.5.0 - 2019-04-15
- add days option to clean command [#497](https://github.com/spatie/laravel-activitylog/pull/497)
- add `LogsActivity::$submitEmptyLogs` [#514](https://github.com/spatie/laravel-activitylog/pull/514)
## 3.4.0 - 2019-04-09
- use `Illuminate\Contracts\Config\Repository` instead of `Illuminate\Config\Repository` [#505](https://github.com/spatie/laravel-activitylog/pull/505)
- fix `logChanges()` [#512](https://github.com/spatie/laravel-activitylog/pull/512)
## 3.3.0 - 2019-04-08
- drop support for Laravel 5.7 and lower
- drop support for PHP 7.1 and lower
## 3.2.2 - 2019-02-27
- add support for Laravel 5.8
- fix logging hidden attributes
- fix logging for a causer model without a provider
- add code coverage reporting for repository
## 3.2.1 - 2019-02-01
- use Str:: and Arr:: instead of helper methods
## 3.2.0 - 2019-01-29
- add `ActivityLogger::tap()` method
- add `LogsActivity::tapActivity()` method
- the `ActivityLogger` will work on an activity model instance instead of cache variables
## 3.1.2 - 2018-10-18
- add `shouldLogUnguarded()` method
- fix typo in methodname `shouldLogOnlyDirty()`
## 3.1.1 - 2018-10-17
- fix `$logUnguarded`
## 3.1.0 - 2018-10-17
- add `$logUnguarded`
## 3.0.0 - 2018-10-16
- the preferred way to get changes on an `Activity` model is through the `changes` property instead of the `changes()` function
- the `activity` relation of the `CausesActivity` trait has been renamed to `actions`
- the `activity` relation of the `LogsActivity` trait has been renamed to `activities`
- the deprecated `loggedActivity` relation has been removed
- the `HasActivity` trait has been removed.
- fix for setting a custom table name for the `Activity` model via the `$table` property
- support for PHP 7.0 has been dropped
## 2.8.4. - 2018-09-23
- improve migration
## 2.8.3 - 2018-09-01
- add support for L5.7
## 2.8.2 - 2018-07-28
- allow `null` to be passed to `causedBy`
## 2.8.1 - 2018-07-28
- make sure a fresh instance of `ActivityLogger` is used
## 2.8.0 - 2018-07-21
- add `enableLogging()` and `disableLogging()`
## 2.7.0 - 2018-06-18
- add ability to ignore changes to attributes specified in `$logAttributesToIgnore`
## 2.6.0 - 2018-04-03
- add `table_name` config option
## 2.5.1 - 2018-02-11
- improve support for soft deletes
## 2.5.0 - 2018-02-09
- allow model to override the default log name
## 2.4.2 - 2018-02-08
- add compatibility with L5.6
## 2.4.1 - 2018-01-20
- use a `text` column for `description`
## 2.4.0 - 2018-01-20
- add `HasActivity`
## 2.3.2 - 2017-12-13
- fix bugs concerning `attributesToBeLogged`
## 2.3.1 - 2017-11-13
- allow nullable relation when using `logChanges`
## 2.3.0 - 2017-11-07
- add a `log` argument to `activitylog:clean`
## 2.2.0 - 2017-10-16
- add support for logging all changed attributes using `*`
## 2.1.2 - 2017-09-28
- fix for logging changes attributes when deleting soft deletable models
## 2.1.1 - 2017-09-12
- make sure `properties` always is a collection
## 2.1.0 - 2017-09-19
- added support for logging fillable attributes
## 2.0.0 - 2017-08-30
- added support for Laravel 5.5, dropped support for older laravel versions
- renamed config file from `laravel-activitylog` to `activitylog`
- rename `getChangesAttribute` function to `changes` so it doesn't conflict with Laravel's native functionality
## 1.16.0 - 2017-06-28
- added `enableLogging` and `disableLogging`
## 1.15.5 - 2017-08-08
- fix model scope
## 1.15.4 - 2017-08-05
- fix detecting `SoftDeletes`
## 1.15.3 - 2017-06-23
- fix for when there is no 'web' guard
## 1.15.2 - 2017-06-15
- fixes errors in `DetectsChanges`
## 1.15.1 - 2017-04-28
- fixes error in `DetectsChanges`
## 1.15.0 - 2017-04-28
- add compatibility with L5.1 and L5.2
## 1.14.0 - 2017-04-16
- add support array/collection casted attributes when using `logDirtyOnly`
## 1.13.0 - 2017-04-16
- add `logDirtyOnly`
## 1.12.2 - 2017-03-22
- fix a bug where changes to a related model would not be logged
## 1.12.1 - 2017-02-12
- avoid PHP error when dealing with placeholders that cannot be filled
## 1.12.0 - 2017-02-04
- drop support for L5.2 and lower
- add ability to log attributes of related models
## 1.11.0 - 2017-01-23
- add support for L5.4
## 1.10.4 - 2017-01-20
- `Activity` now extends from `Model` instead of `Eloquent`
## 1.10.2 - 2016-11-26
- fix compatibilty for Laravel 5.1
## 1.10.1 - 2016-10-11
- fix `scopeCausedBy` and `scopeForSubject`
## 1.10.0 - 2016-10-10
- add support for `restored` event
## 1.9.2 - 2016-09-27
- fixed a bug where the delete event would not be logged
## 1.9.1 - 2016-09-16
- fixed the return value of `activity()->log()`. It will now return the created `Activity`-model.
## 1.9.0 - 2016-09-16
- added `Macroable` to `ActivityLogger`
## 1.8.0 - 2016-09-12
- added `causedBy` and `forSubject` scopes
## 1.7.1 - 2016-08-23
- Added L5.3 compatibility
## 1.7.0 - 2016-08-17
- Added `enabled` option in the config file.
## 1.6.0 - 2016-08-11
- Added `ignoreChangedAttributes`
## 1.5.0 - 2016-08-11
- Added support for using a custom `Activity` model
## 1.4.0 - 2016-08-10
- Added support for soft deletes
## 1.3.2 - 2016-08-09
- This version replaces version `1.3.0`
- Dropped L5.1 compatibility
## 1.3.1 - 2016-08-09
- this version removes the features introduced in 1.3.0 and is compatible with L5.1
## 1.3.0 - 2016-07-29
**DO NOT USE THIS VERSION IF YOU'RE ON L5.1**
Please upgrade to:
- `1.3.1` for Laravel 5.1
- `1.3.2` for Laravel 5.2 and higher
Introduced features
- made the auth driver configurable
## 1.3.0 - 2016-07-29
- made the auth driver configurable
## 1.2.1 - 2016-07-09
- use config repo contract
## 1.2.0 - 2016-07-08
- added `getLogNameToUse`
## 1.1.0 - 2016-07-04
- added `activity`-method on both the `CausesActivity` and `LogsActivity`-trait
## 1.0.3 - 2016-07-01
- the package is now compatible with Laravel 5.1
## 1.0.2 - 2016-06-29
- fixed naming of `inLog` scope
- add `inLog` function alias
## 1.0.1 - 2016-06-29
- fixed error when publishing migrations
## 1.0.0 - 2016-06-28
- initial release