# 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
