grinet/cms-version

Magento 2 module for versioning CMS Pages and Blocks with admin metadata and restore functionality.

1.0.0 2026-01-11 08:49 UTC

Requires

• php: ~7.4.0||~8.1.0||~8.2.0||~8.3.0
• magento/module-backend: *
• magento/module-cms: *
• magento/module-user: *

MIT

• Grinet
• Hidayet OK

README

A powerful Magento 2 module that automatically tracks changes to CMS Pages and Blocks. It captures the state of content before every save, including detailed administrator metadata, and provides a seamless restoration process.

Features

• Automatic Backups: Automatically creates a version of a CMS Page or Block before any modifications are saved.
• Detailed Metadata: Tracks who made the change, from which IP address, and at what time.
  • Admin User ID
  • Admin Username
  • Admin IP Address
  • Creation Timestamp
• Version History Grid: Integrated directly into the CMS Page and Block edit forms.
• One-Click Restore: Revert to any previous version with a single click.
• ACL Permissions: Granular control over who can view and restore versions.
• Store-Aware: Correctly handles store associations during backup and restoration.

Requirements

• Magento 2.4.x
• PHP 7.4 | 8.1 | 8.2 | 8.3

Installation

Via Composer (Recommended)

composer require grinet/module-cms-version
php bin/magento setup:upgrade
php bin/magento cache:flush

Manual Installation

1. Download the module and extract it to app/code/Grinet/CmsVersion.
2. Run the following commands:

php bin/magento module:enable Grinet_CmsVersion
php bin/magento setup:upgrade
php bin/magento cache:flush

Usage

1. Navigate to Content > Elements > Pages or Blocks.
2. Edit any existing item.
3. After saving changes, scroll to the bottom of the page to find the Version History section.
4. You will see a list of previous versions.
5. Click Restore on any version to revert the content and settings to that specific point in time.

Permissions

You can manage access to this module under System > Permissions > User Roles:

• Grinet_CmsVersion::view: Allows viewing the version history grid.
• Grinet_CmsVersion::restore: Allows restoring a previous version.

License

This project is licensed under the MIT License - see the LICENSE.txt file for details.

Support

For any issues or feature requests, please open an issue on the GitHub repository.

Developed by Grinet and Hidayet OK