Rollback Manager

The Rollback Manager module lets you safely revert WordPress.org themes and plugins to earlier versions directly from your admin dashboard. Whether fixing compatibility issues, undoing a problematic update, or testing different releases, this tool helps maintain site stability with just a few clicks.

How to use

To enable the Rollback Manager:

1. Click on the “Utilities” category
2. Search or scroll to locate the Rollback Manager Module
3. Click on the switch to enable

What’s next?

This module allows you to safely rollback any WordPress.org theme or plugin to a previous version.

1. Accessing Rollback Manager

1. Navigate to WP mazic > Rollback Manager in your WordPress admin
2. Or, click the “Rollback” link in the plugins or themes list

2. Rolling Back a Plugin

1. Select “Plugin” from the Type dropdown
2. Choose the plugin you want to rollback from the Plugins dropdown
3. Select the version you want to roll back to
4. Click the “Rollback” button
5. Wait for the process to complete

3. Rolling Back a Theme

1. Select “Theme” from the Type dropdown
2. Choose the theme you want to rollback from the Themes dropdown
3. Select the version you want to roll back to
4. Click the “Rollback” button
5. Wait for the process to complete

4. Quick Rollback from Plugins Page

1. Go to Plugins > Installed Plugins
2. Find the plugin you want to rollback
3. Click the “Rollback” link in the plugin’s action links
4. This will take you directly to the Rollback Manager with the plugin pre-selected

5. Quick Rollback from Themes Page

1. Go to Appearance > Themes
2. Hover over the theme you want to rollback
3. Click “Theme Details”
4. Click the “Rollback” link in the theme details
5. This will take you directly to the Rollback Manager with the theme pre-selected

6. Best Practices

1. Backup First: Always backup your site before performing a rollback
2. Test After Rollback: Check your site thoroughly after rolling back
3. Update Carefully: After a successful rollback, consider waiting for the next stable release before updating again
4. Check Compatibility: Ensure the rolled-back version is compatible with your current WordPress version

7. Troubleshooting

• No Versions Available:
  • The theme/plugin might not be from WordPress.org
  • Check your internet connection
  • The theme/plugin might not have any previous versions
• Rollback Fails:
  • Check file permissions
  • Ensure you have enough server resources
  • Check your server’s error logs
• Plugin/Theme Not Working After Rollback:
  • Clear your cache
  • Deactivate and reactivate the plugin/theme
  • Check for conflicts with other plugins

8. Developer Hooks

// Filter available plugins for rollback
add_filter('WPMazic/rollback/available_plugins', function($plugins) {
    // Modify $plugins array
    return $plugins;
});

// Filter available themes for rollback
add_filter('WPMazic/rollback/available_themes', function($themes) {
    // Modify $themes array
    return $themes;
});

// Action before rollback
add_action('WPMazic/rollback/before_rollback', function($type, $slug, $version) {
    // Your code here
}, 10, 3);

// Action after successful rollback
add_action('WPMazic/rollback/after_rollback', function($type, $slug, $version) {
    // Your code here
}, 10, 3);

9. Security Considerations

• Only administrators can access the Rollback Manager
• All requests are verified for security
• Only themes and plugins from WordPress.org are supported
• Direct file access is restricted

10. Notes

• The Rollback Manager only works with themes and plugins from WordPress.org
• Custom or premium themes/plugins cannot be rolled back using this tool
• Always test rollbacks on a staging site first when possible

This module is particularly useful for:

• Fixing compatibility issues after updates
• Reverting problematic updates
• Testing different versions of plugins/themes
• Maintaining site stability during development