Roll a layout back #

In the editor, Discard throws away a draft; it does not bring back a version that was published before. An export taken before the change is a way back that works from the command line, on any installation.

Contents #

1. Before the change: export
2. Make the change
3. Roll back: preview
4. Roll back: write
5. The page cache

1. Before the change: export #

$ ./console exp:layouts export --only=d14c82715a0c5f1da1e6df4d0b77e638 --output=prefooter-before.zip
Wrote prefooter-before.zip: 1 layouts (1 shared, 0 drafts), 4 blocks, 0 mappings, 3 content references.

The administration does the same under Layouts > Export. Keep the file with a date in its name, or in your project's repository.

2. Make the change #

On the test copy the Prefooter got a fourth article, then the view type list_compact, then a Notice block (Change the prefooter in the Layouts editor).

3. Roll back: preview #

$ ./console exp:layouts import prefooter-before.zip --dry-run
State        Action      Kind       Key
changed      skip        layout     layout:d14c82715a0c5f1da1e6df4d0b77e638:published
Totals: 0 new, 0 identical, 1 changed, 0 conflicting.
Dry run: nothing was written.

changed with the default strategy skip would leave the layout alone. Preview the overwrite:

$ ./console exp:layouts import prefooter-before.zip --dry-run --strategy=overwrite --publish
State        Action      Kind       Key
changed      overwrite   layout     layout:d14c82715a0c5f1da1e6df4d0b77e638:published
Totals: 0 new, 0 identical, 1 changed, 0 conflicting.
Dry run: nothing was written.

4. Roll back: write #

$ ./console exp:layouts import prefooter-before.zip --strategy=overwrite --publish
State        Action      Kind       Key
changed      overwrite   layout     layout:d14c82715a0c5f1da1e6df4d0b77e638:published
Totals: 0 new, 0 identical, 1 changed, 0 conflicting.
Written: layout:d14c82715a0c5f1da1e6df4d0b77e638:published overwritten and published (ID 7)
1 items written; 0 resolver cache entries removed.

The layout keeps its ID (7) and identifier, so every layout that links to it keeps working. After the import it had its three original articles again and none of the added blocks.

Without --publish the imported version becomes a draft, to check in the editor before publishing.

5. The page cache #

Since explayouts_core 1.0.10 the import with --publish purges every page of the page cache itself, so the article pages show the restored prefooter on their next view; no cache has to be cleared by hand. An import without --publish, a dry run or a refused import purges nothing.

Related pages #

• Export and import layouts
• Change the prefooter in the Layouts editor
• Free documentation: this page is free to copy, translate and improve under the GNU FDL 1.3.