WordPress Reset

Overview

The WordPress Reset module provides a powerful and safe way to reset various parts of your WordPress website. Think of it as a tool that helps you clean up or restart specific sections of your site without affecting everything at once. This is particularly useful when you want to start fresh with certain content, remove unused data, or troubleshoot issues by resetting specific components.

What You Can Reset

Content Reset

This option allows you to remove all the content from your website, including:

• All posts and pages
• Comments and comment metadata
• Categories, tags, and other taxonomies
• Custom post types

This is like clearing out all the text and media content from your site while keeping the structure intact. After resetting content, you'll have a clean slate to start adding new posts and pages.

Users Reset

This feature removes all user accounts from your website except for the current administrator account. This is helpful when:

• You want to clean up old or unused user accounts
• You're preparing a site for a new team
• You need to remove test accounts created during development

Your current administrator account will always be preserved, so you'll never lose access to your site.

Options Reset

This resets your WordPress settings back to their default values. Think of this as restoring your site's configuration to how it was when you first installed WordPress. However, it intelligently preserves important settings like:

• Your site URL and name
• Administrator email address
• Time zone and language settings
• Permalink structure
• Active plugins list

This helps you reset problematic settings without losing your site's basic identity and configuration.

Drop Custom Tables

This option removes database tables that were created by plugins or themes but are no longer part of the core WordPress system. These custom tables can accumulate over time as you install and remove plugins. Removing them helps:

• Clean up your database
• Improve database performance
• Remove orphaned data from uninstalled plugins

Core WordPress tables are always protected and will never be removed.

Reset wp-content Components

This section allows you to clean up specific folders in your WordPress installation:

Inactive Plugins

Removes all plugins that are currently not active on your site. This helps:

• Clean up your plugins folder
• Remove unused plugin files
• Free up disk space

Active plugins and the Devdoit Sweep plugin itself are always preserved.

Inactive Themes

Deletes all themes that are not currently active on your site. This is useful for:

• Removing old or unused themes
• Cleaning up your themes folder
• Keeping only the theme you're actually using

Your currently active theme and its parent theme are always protected.

Uploads Folder

This option permanently deletes all files in your uploads folder, including:

• All images
• All documents
• All media files uploaded to your site

This is a permanent action and cannot be undone. Use this option with extreme caution, as it will remove all media content from your site.

Safety Features

The WordPress Reset module includes multiple safety features to protect your site:

Dry Run Mode

Before performing any reset operation, you can run a "dry run" to see exactly what will be affected. This is like a preview that shows you:

• How many items will be removed
• The total size of data that will be deleted
• A detailed list of what will be affected

The dry run uses the same logic as the actual reset but doesn't make any changes, allowing you to review the impact before committing.

Automatic Backups

The module automatically creates a backup before any destructive operation. This ensures that:

• You can always restore your site if something goes wrong
• Backups are stored separately from your main site
• You can restore with a single click

Confirmation Dialogs

Every reset operation requires explicit confirmation. The system shows you:

• A clear warning about the consequences
• A detailed list of what will be affected
• An opportunity to cancel the operation

Nothing happens automatically - you must confirm each action.

Audit Logging

All reset operations are logged, recording:

• Who performed the action
• When it was performed
• What was affected
• The outcome of the operation

This helps you track changes and troubleshoot any issues.

Security Protections

The module implements multiple security measures:

• Only administrators can access reset functions
• All actions require security verification
• Rate limiting prevents accidental multiple operations
• Protected files and core WordPress components are never deleted

How to Use

1. Select What to Reset: Check the boxes next to the components you want to reset. You can choose one or multiple options.
2. Review Details: Click on the accordion sections to see detailed information about what will be affected. Each section shows:
   • The total number of items
   • The total size of data
   • A searchable, sortable list of specific items
3. Run Dry Run: Click the "Run Detailed Dry Run" button to preview the changes without actually making them. Review the results carefully.
4. Confirm and Execute: If you're satisfied with the dry run results, click "Reset Selected Items" and confirm the operation in the dialog that appears.
5. Monitor Progress: For large operations, a progress bar shows you the status in real-time.
6. Verify Results: After the operation completes, verify that your site is working as expected.

Best Practices

• Always Create a Backup: Even though the module creates automatic backups, it's good practice to have a recent manual backup before performing major resets.
• Start with Dry Run: Always run a dry run first to understand the impact of your actions.
• Reset One Category at a Time: When possible, reset one category at a time rather than everything at once. This makes it easier to identify any issues.
• Test After Reset: After performing a reset, test your site thoroughly to ensure everything is working correctly.
• Keep Backups Accessible: Keep your backups accessible for a reasonable period after performing resets, in case you need to restore.

When to Use This Module

The WordPress Reset module is useful in various scenarios:

• Site Development: When you're building a new site and want to clean up test content and users.
• Site Migration: When moving a site and you want to remove unnecessary data before the transfer.
• Troubleshooting: When you suspect that corrupted data or settings are causing issues.
• Performance Optimization: When you want to remove accumulated data that's slowing down your site.
• Starting Fresh: When you want to keep your site's structure but remove all the content.

Important Notes

• Permanent Actions: Most reset operations are permanent and cannot be undone. Always review the dry run results carefully.
• Administrator Account: Your current administrator account is always preserved during user resets.
• Active Components: Active plugins and themes are never removed during wp-content resets.
• Core Protection: Core WordPress tables and files are always protected and cannot be deleted.
• Backup Requirement: Some operations may require a recent backup before they can be executed.

Support and Documentation

For more detailed information about using the WordPress Reset module, including advanced features and troubleshooting, please refer to the official documentation at devdoit-sweep.com/docs/wordpress-reset.