zauberfisch / silverstripe-persistent-dataobject
Persistent and optionally immutable & versioned DataObjects for SilverStripe
Installs: 149
Dependents: 1
Suggesters: 0
Security: 0
Stars: 2
Watchers: 2
Forks: 1
Open Issues: 0
Type:silverstripe-module
Requires
- silverstripe/framework: ^3.7
This package is auto-updated.
Last update: 2024-09-23 14:49:36 UTC
README
Persistent and optionally immutable & versioned DataObjects for SilverStripe
The two major features of this module are:
- A DataObject subclass that can not be deleted
Calling->delete()
will mark an object as deleted, but not actually delete it
(Where necessary, objects can still be deleted by calling->purge()
) - A DataObjectExtension that adds versioning
In contrast to the "silverstripe-versioned" module, versioning is achived by making DataObjects immutable and overloading->write()
to create a duplicate of the current record instead of saving the existing.
This means theID
becomes the unique version number, while an additionalVersionGroupID
andVersionGroupLatest
keep track of the relation of records. The benefit of this approach is being able to easily reference a version of an entry rather than always the latest version. Thus making it possible to have persistent storage of information that is easily integrable in other parts of SilverStripe (eg an invoice can safely reference a product price and does not need to create a snapshot).
TODOs / Planed features
- Tests
- Revisit decision to put VersionGroup_ID on DataObject rather than subclasses
- Extend GridField integration
- Hide/Show deleted records button
- History view to access older version from within a DataObject
- Implement non GridField form fields (eg Relation Dropdown that let's the user pick a entry and a version)
- Implement Database Field/Relation that references VersionGroupID instead of ID?
- Documentation
- Explain the usecase in more detail
- Examples
- SilverStripe 4 Support