grinet / cms-version

1.0.1 2026-11-09 00:09 UTC

Requires

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

MIT

• Grinet
• Hidayet OK

• magento2
• mageOS
• mage-os

Published on Packagist.org on 2026-11-09 00:41 UTC

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 | 8.4 | 8.5

Installation

Via Composer (Recommended)

composer require grinet/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

PHP compatibility

PHP 8.5 syntax and PHPCompatibility static checks were run on this release. Existing minimum PHP requirements are retained. Use a Magento release that supports your PHP runtime; syntax/static checks alone do not verify installation, DI compilation or storefront/admin behavior.

The Composer mage-os and mageos keywords indicate expected compatibility based on Mage-OS retaining Magento namespaces and replacing the corresponding magento/* packages. The existing Magento requirements are preserved. No full Mage-OS integration test was performed. See https://mage-os.org/faq/ and https://repo.mage-os.org/packages.json.