Download the PHP package axllent/silverstripe-version-truncator without Composer
On this page you can find all versions of the php package axllent/silverstripe-version-truncator. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download axllent/silverstripe-version-truncator
More information about axllent/silverstripe-version-truncator
Files in axllent/silverstripe-version-truncator
Package silverstripe-version-truncator
Short Description Automatically delete old versioned Silverstripe records from the database
License MIT
Homepage https://github.com/axllent/silverstripe-version-truncator
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package silverstripe-version-truncator
Version truncator for Silverstripe
An extension for Silverstripe to automatically delete old versioned DataObject records from your database when a record is published, following predefined retention policies (see configuration).
When a record is being edited (such as a Page), no changes are made until it is published, so it could have 50 draft versions while you work on the copy. When you publish the page, the module prunes the (by default) all draft copies, leaving just the 10 latest published versions (configurable).
Features
- Delete all but the last XX published versions of a DataObject on publish
- Delete all but the last YY draft versions of a DataObject on publish
- Optionally keep old SiteTree objects where the URLSegment has changed (to preserve redirects)
Tasks
The module adds three manual tasks to:
- Force a run over the entire database - this task is generally not needed unless you either just install the module and wish to tidy up, or change your DataObject configurations.
- Silverstripe does not currently delete any File records once the file had been physically deleted (probably due to the immediate post-delete functionality relating to internal file linking). I cannot see any purpose of keeping these records after this, so this task will remove all records pertaining to deleted files/folders.
- Force a "reset", keeping only the latest published version of each currently published DataObject (regardless of policy). Unpublished / modified DataObjects are not touched.
- Delete all archived DataObjects.
The tasks can be run via /dev/tasks/TruncateVersionsTask.
Requirements
- Silverstripe ^4.5 || ^5.0
Installation
composer require axllent/silverstripe-version-truncator
Configuration
Configuration is optional (see Default config), however you can create a YML file (eg: app/_config/version-truncator.yml):
To skip pruning altogether for a particular DataObject, set keep_versions: 0 for that object class.
To overwrite the global defaults, see _config/extension.yml, eg:
Default config
SiteTree (and extending classes eg: Page etc)
On publish, the last 10 published versions are kept, and all draft copied are removed. The only exception is if the URLSegment and/or ParentID is has changed, in which case the module will keep a single record for each differing URLSegment to allow auto-redirection.
All other DataObjects
For all other versioned DataObjects, only the latest published version is kept, and all drafts deleted. This can be adjusted per DataObject, or globally (see above).
