heyday / silverstripe-versioneddataobjects
Provides Versioned DataObjects in SilverStripe
Installs: 165 020
Dependents: 6
Suggesters: 0
Security: 0
Stars: 21
Watchers: 29
Forks: 24
Type:silverstripe-module
Requires
- composer/installers: ~1.0
Requires (Dev)
- phpunit/phpunit: ~3.7
README
This module provides an easy to use implementation of SilverStripe's built-in Versioned
extension for DataObjects, along with admin components to manage your versioned things.
IMPORTANT: Versioning of DataObjects is built-in to the Versioned
extension in SilverStripe 4.x and newer.
Installation (with composer)
$ composer require heyday/silverstripe-versioneddataobjects
Usage
The VersionedDataObject
extension adds the same draft/published versioning used for pages to your own DataObjects, and any subclasses they have. Only fields in the table of a DataObject with this extension will be versioned. Related DataObjects need VersionedDataObject
applied separately if required.
class Slice extends DataObject { private static $db = [ 'Content' => 'Text' ]; private static $has_one = [ 'Parent' => 'SiteTree' ]; private static $extensions = [ 'Heyday\VersionedDataObjects\VersionedDataObject' ]; }
Versioned DataObjects in a GridField
To use VersionedDataObject
records in a GridField, GridFieldDetailForm
needs to be replaced with VersionedDataObjectDetailsForm
:
// ... public function getCMSFields() { $fields = parent::getCMSFields(); $fields->addFieldToTab( 'Root.Slices', new GridField( 'Slices', 'Slices', $this->Slices(), $config = GridFieldConfig_RelationEditor::create() ) ); $config->removeComponentsByType('GridFieldDetailForm'); $config->addComponent(new Heyday\VersionedDataObjects\VersionedDataObjectDetailsForm()); return $fields; } // ...
Versioned DataObjects in a ModelAdmin
class SliceAdmin extends Heyday\VersionedDataObjects\VersionedModelAdmin { private static $menu_title = 'Slices'; private static $url_segment = 'slice'; private static $managed_models = [ 'Slice' ]; }
Cavets / Troubleshooting
SilverStripe's versioning system uses global state to keep track of a "reading mode" that affects which tables records are read from and written to for all uses of the Versioned
extension. This works on the front end of a site where you expect to see the currently selected stage, however it also alters what records are visible in the CMS if not adjusted for. The admin components supplied with this module work around this to always show draft records in the CMS.
If you have control over an ORM query, you can alter the behaviour of Versioned
with DataQuery parameters to override the global reading mode setting:
VersionedFoo::get() ->setDataQueryParam(['Versioned.stage' => 'Stage']);
If you can't modify a query, you can use VersionedReadingMode
from this module to change and restore the global reading mode around a piece of code:
VersionedReadingMode::setStageReadingMode(); // ... code that runs queries VersionedReadingMode::restoreOriginalReadingMode();
If you suspect you might be seeing an issue from incorrect reading mode, the global reading mode can be changed between live and stage by adding the query string ?stage=Stage
or ?stage=Live
to the current URL.
BetterButtons compatibility
This module works with unclecheese/betterbuttons
version 1.2.8
.
Unit testing
None :(
##License
SilverStripe Versioned DataObjects is licensed under an MIT license