Editing pages

Version history

Every save of the blocks of a page creates a version. You can look at a previous version in the Editor, put it back online and name the important versions.

What is recorded

• A version is created by every save that changes the blocks of the page: content, order, a block added or removed. A save that does not change the blocks creates no version.
• The history is kept per language: each language of the page has its own versions.
• Each version keeps its date, its author and its number of blocks.
• Versions are created whatever the way the page is saved: from the Editor, from the classic page form or from code.
• For a page created before 2.3, the first save also keeps the previous state of the blocks: that first change can be undone.

Open the history

1. Open the page in the Editor.
2. Click History in the document toolbar. The button is available once the page is saved.
3. The Block history dialog lists the versions of the displayed language, newest first. The version online is labelled Current version.

The search field filters the versions on their title and description.

Go back to a previous version

1. In the history, click Preview on the version you want. If the page has unsaved changes, a confirmation warns you that they will be lost.
2. The blocks of that version are shown in the Editor and in the preview. A banner tells which version is displayed, and the tab is flagged as changed.
3. Click Save: that version is put back online.

To leave the preview without changing anything, click Back to the current version in the banner.

Before saving, you can also edit the blocks of the previewed version: they are saved like any other change.

Name a version

Give a name to the important versions, for example before a redesign or for a campaign:

1. In the history, click Name / Edit on the version.
2. Enter a Title and, if needed, a Description.
3. Click Save.

How many versions are kept?

• The last 50 versions are kept per page and language. Older ones are deleted automatically.
• Named versions (with a title) are never deleted automatically and do not count towards that limit.
• Deleting a page also deletes its history.

For developers

The history is built on the LucasPalomba\PageTree\Traits\Versionable trait, which your own models can use:

class Article extends Model
{
    use \LucasPalomba\PageTree\Traits\Versionable;

    // Attributes with a history
    public $versionable = ['content'];

    // Unnamed versions kept per record and language
    public $versionableLimit = 50;
}

• Versions are stored in the lucaspalomba_pagetree_versions table and available through the pagetree_versions relation.
• With RainLab.Translate, each saved language has its own versions.
• Until php artisan october:migrate has created the table, models are saved as usual, without history.