SilverStripe Data Change Tracker
- SilverStripe 3
Record and track changes and deletes of any dataobjects. View changes/diffs in model admin.
Install via composer, run dev/build
composer require silverstripe-australia/datachange-tracker
Add the ChangeRecordable extension to the dataobjects you wish to track
MyDataObject: extensions: - ChangeRecordable
If you are applying the extension to the SiteTree, use the SiteTreeChangeRecordable extension to record publish/unpublish actions
Capturing URL parameters
save_request_vars option to 1, and GET and POST vars will be recorded too.
DataChangeRecord: save_request_vars: 1
In some cases it may not be desirable to track changes to all fields of an object. You can define ignored fields in your yml config like so:
ChangeRecordable: ignored_fields: NameOfObjectClass: - NameOfField
Or, for the same field name across all objects
DataChangeRecord: field_blacklist: - Password - Email
Also, you may wish to blacklist some request variables from being stored
DataChangeRecord: request_vars_blacklist: - url - SecurityID
Significant Change tracking
Sometimes reporting changes to certain fields to CMS users is desirable (e.g seeing the last time a field was updated).
This is handled by
SignificantChangeRecordable, which looks for a list of
TeamMember: significant_fields: - 'Name' - 'Address' - 'OfficeNumber' - 'Position' - 'Mobile' extensions: - 'ChangeRecordable' - 'SignificantChangeRecordable'
- Removed static DataChangeRecord::track() method