Title: NaveenCodes Safe Mode
Author: Naveen Goyal
Published: <strong>June 19, 2026</strong>
Last modified: June 19, 2026

---

Search plugins

![](https://ps.w.org/naveencodes-safe-mode/assets/banner-772x250.png?rev=3578067)

![](https://ps.w.org/naveencodes-safe-mode/assets/icon-256x256.png?rev=3578067)

# NaveenCodes Safe Mode

 By [Naveen Goyal](https://profiles.wordpress.org/shinu1503/)

[Download](https://downloads.wordpress.org/plugin/naveencodes-safe-mode.1.0.2.zip)

 * [Details](https://wordpress.org/plugins/naveencodes-safe-mode/#description)
 * [Reviews](https://wordpress.org/plugins/naveencodes-safe-mode/#reviews)
 *  [Installation](https://wordpress.org/plugins/naveencodes-safe-mode/#installation)
 * [Development](https://wordpress.org/plugins/naveencodes-safe-mode/#developers)

 [Support](https://wordpress.org/support/plugin/naveencodes-safe-mode/)

## Description

NaveenCodes Safe Mode helps restore access after fatal plugin or theme crashes. 
It detects fatal PHP shutdown errors, identifies whether the source is a plugin 
or theme, performs the configured recovery action, records detailed logs, stores
recovery history, shows persistent admin notices, and emails administrators.

The plugin does not modify, rewrite, or repair user code. Version 1 is focused only
on detection, disabling, recovery, logging, and notification.

### Version 1 Architecture

 * Namespace: `NaveenCodes\SafeMode`
 * Prefix: `ncsm_`
 * Text domain: `naveencodes-safe-mode`
 * Bootstrap: `naveencodes-safe-mode.php`
 * Autoloading: lightweight PSR-4 style autoloader for `includes/`
 * Composition root: `includes/Core/Plugin.php`
 * Service boundaries:
    - `Core`: activation, deactivation, settings, plugin bootstrapping
    - `Database`: custom table schema
    - `Recovery`: shutdown detection, source detection, queueing, plugin/theme recovery,
      notifications
    - `Logging`: error logs and recovery history persistence
    - `Admin`: dashboard, logs, history, settings, notices, coming soon UI
    - `Helpers`: focused WordPress helper utilities
    - `Interfaces`: shared service contracts

### Database Schema

    ```
    wp_ncsm_logs
    ```

 * `id`
 * `timestamp`
 * `error_type`
 * `error_message`
 * `file_path`
 * `line_number`
 * `source_type`
 * `source_name`
 * `action_taken`
 * `recovery_status`
 * wp_ncsm_recovery_history
 * `id`
 * `timestamp`
 * `source_type`
 * `source_name`
 * `recovery_action`
 * `recovery_result`

### Recovery Workflow

 1.  Register a shutdown function early on `plugins_loaded`.
 2.  Inspect `error_get_last()` on shutdown.
 3.  Continue only for fatal, parse, compile, core, user, or recoverable fatal errors.
 4.  Detect source from the error file path:
 5.   * `wp-content/plugins/...` becomes a plugin source.
      * `wp-content/themes/...` becomes a theme source.
      * Anything else is stored as Unknown Source.
 6.  Check recovery queue attempts for the source.
 7.  If the source is a plugin and plugin auto-disable is enabled, deactivate the faulty
     plugin.
 8.  If the source is the active theme and theme recovery is enabled, switch to the
     configured fallback theme.
 9.  Log the error and recovery action.
 10. Store recovery history.
 11. Add a persistent admin notice.
 12. Send an administrator email when enabled.

### WordPress Hooks

 * `plugins_loaded` boots the plugin.
 * `register_shutdown_function()` detects fatal shutdown errors.
 * `admin_menu` registers the admin pages.
 * `admin_enqueue_scripts` loads admin assets.
 * `admin_notices` renders persistent recovery notices.
 * `admin_post_ncsm_save_settings` saves settings.
 * `admin_post_ncsm_export_logs` exports logs.
 * `admin_post_ncsm_dismiss_notice` dismisses recovery notices.

### Admin Pages

 * Dashboard: protection status, statistics, and recovery workflow.
 * Error Logs: fatal error log table, filters, and CSV export.
 * Recovery History: source, action, result, and timestamp.
 * Settings: recovery toggles, notifications, fallback theme, retention, maximum
   attempts.
 * Coming Soon: Version 2 feature previews only.

### Settings

 * Enable Recovery
 * Enable Plugin Auto Disable
 * Enable Theme Recovery
 * Enable Email Notifications
 * Fallback Theme Selector
 * Log Retention Period
 * Maximum Recovery Attempts

### Coming Soon

The following features are displayed as UI-only cards and are not implemented in
Version 1:

 * Automatic Rollback
 * Update Sandbox Testing
 * Code Snippet Protection
 * AI Error Analysis
 * Slack Notifications
 * Cloud Backups
 * Uptime Monitoring
 * One Click Restore

### Security

Version 1 uses capability checks, nonces, sanitization, escaping, WordPress database
APIs, and prepared SQL for dynamic values. It performs no tracking, no hidden data
collection, no remote code execution, and no unsafe file rewriting.

## Screenshots

[⌊Admin notice shown after automatic recovery — confirms what failed and what action
was taken.⌉⌊Admin notice shown after automatic recovery — confirms what failed and
what action was taken.⌉[

Admin notice shown after automatic recovery — confirms what failed and what action
was taken.

[⌊Error Logs — filterable table of every fatal error with source, file, line, and
recovery status.⌉⌊Error Logs — filterable table of every fatal error with source,
file, line, and recovery status.⌉[

Error Logs — filterable table of every fatal error with source, file, line, and 
recovery status.

[⌊Recovery History — chronological record of every recovery action and its outcome.⌉⌊
Recovery History — chronological record of every recovery action and its outcome
.⌉[

Recovery History — chronological record of every recovery action and its outcome.

[⌊Settings — toggle recovery, auto-disable, theme fallback, email notifications,
and retention controls.⌉⌊Settings — toggle recovery, auto-disable, theme fallback,
email notifications, and retention controls.⌉[

Settings — toggle recovery, auto-disable, theme fallback, email notifications, and
retention controls.

## Installation

 1. Upload the `naveencodes-safe-mode` folder to `/wp-content/plugins/`.
 2. Activate the plugin from the WordPress Plugins screen.
 3. Go to Safe Mode > Settings and choose a fallback theme.

## FAQ

### Does this plugin fix broken PHP code?

No. It only detects fatal errors, disables faulty plugins or switches broken themes,
logs what happened, and notifies administrators.

### Can it recover from every crash?

No recovery plugin can guarantee recovery from all fatal errors. WordPress must 
load NaveenCodes Safe Mode before the crash occurs so its shutdown handler can run.

### Does Version 1 include rollback or AI analysis?

No. Those appear only in the Coming Soon section.

## Reviews

There are no reviews for this plugin.

## Contributors & Developers

“NaveenCodes Safe Mode” is open source software. The following people have contributed
to this plugin.

Contributors

 *   [ Naveen Goyal ](https://profiles.wordpress.org/shinu1503/)

[Translate “NaveenCodes Safe Mode” into your language.](https://translate.wordpress.org/projects/wp-plugins/naveencodes-safe-mode)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/naveencodes-safe-mode/),
check out the [SVN repository](https://plugins.svn.wordpress.org/naveencodes-safe-mode/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/naveencodes-safe-mode/)
by [RSS](https://plugins.trac.wordpress.org/log/naveencodes-safe-mode/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 1.0.2

 * Fixed: Plugin URI corrected to the WordPress.org plugin page — “View plugin” 
   now links correctly in the plugins list.

#### 1.0.1

 * Added: Maa tribute in the WP admin footer — shown on every Safe Mode screen, 
   matching all other NaveenCodes plugins.

#### 1.0.0

 * Initial Version 1 release.
 * Fatal error detection.
 * Plugin auto-disable recovery.
 * Theme fallback recovery.
 * Recovery queue and attempt limits.
 * Custom error logs and recovery history tables.
 * Admin dashboard, logs, history, settings, notices, email notifications, and Coming
   Soon UI.

## Meta

 *  Version **1.0.2**
 *  Last updated **13 hours ago**
 *  Active installations **Fewer than 10**
 *  WordPress version ** 6.5 or higher **
 *  Tested up to **7.0**
 *  PHP version ** 8.0 or higher **
 * Tags
 * [fatal error](https://wordpress.org/plugins/tags/fatal-error/)[recovery](https://wordpress.org/plugins/tags/recovery/)
   [safe mode](https://wordpress.org/plugins/tags/safe-mode/)
 *  [Advanced View](https://wordpress.org/plugins/naveencodes-safe-mode/advanced/)

## Ratings

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/naveencodes-safe-mode/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/naveencodes-safe-mode/reviews/)

## Contributors

 *   [ Naveen Goyal ](https://profiles.wordpress.org/shinu1503/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/naveencodes-safe-mode/)