CMS Import-Export extension allows you to work with CMS pages, blocks, and the media files used in these onto your computer and back up them on the server. The extension doesn’t have a separate configuration page, and all its functions are available in Magento Admin Panel -> Content -> Elements -> Pages (or Blocks). The following functions become available once the plugin is installed:
Export
Export can be done in two ways:
1. Export from the list of pages or blocks. To do this, go to Admin Panel -> Content -> Elements -> Pages (or Blocks) and check the elements you need to export. You will be able to download the selected elements as separate JSON files in a ZIP file.
2. On the list of pages or blocks, go to the Action column, and click Edit. You will be redirected to a webpage that allows you to modify this element. Click Export in the top right corner. You will be able to download a ZIP archive containing that page or block in JSON format.
Import
To import a CMS page or block, go to Admin Panel -> Content -> Elements -> Pages (or Blocks) and click the Import button in the top right corner of the page.
You will be redirected to the import webpage, which allows you to upload a ZIP file previously created by the CMS Import-Export extension.
Additional settings are available for import:
Media Import Mode:
- do not import - default value. The extension will upload only the page/block JSON file, which includes text content with formatting, hyperlinks, etc, but without any media (images, videos, etc).
- overwrite existing - the extension will upload the page/block JSON file and all the media available in the ZIP file. The media files that have the same path and names on the server will be removed and replaced with the files from the uploaded archive.
- skip existing - the extension will upload the page/block JSON file. It will keep all the existing files with the same names and paths on the server. All the files that are absent on the server and present in the ZIP file will be added to the server.
CMS Import Mode:
- overwrite existing - default value. The extension will upload the JSON file, check the names of pages and blocks, and replace the content of all existing pages or blocks with matching names with content from the file.
- skip existing - the extension will upload the JSON file, check the names of pages and blocks, and keep the content of all existing pages or blocks with matching names as is. All the entities that are not present on the server but are present in the file will be added.
Backup
To do this, go to Admin Panel -> Content -> Elements -> Pages (or Blocks) and check the elements you need to back up.
The extension will prepare a ZIP archive that contains all the pages (or blocks) and all related media, including the paths to them. Example of the file structure in the acrhive:
The archive can be downloaded, and also it will be automatically stored on your server. The path is:
- For CMS blocks: /var/cms/blocks/history
- For CMS pages: /var/cms/pages/history