Fatal Plugin Auto Deactivator – Never let a plugin break your site

The Fatal Plugin Auto Deactivator plugin is a powerful tool designed to enhance the stability and reliability of your WordPress website. It automatically detects and deactivates plugins that cause fatal errors, preventing your entire site from crashing and becoming inaccessible.

Key Features

• Automatic Error Detection: Monitors for fatal PHP errors in real-time using WordPress drop-in technology

• Smart Plugin Identification: Identifies which plugin caused the fatal error by matching the error’s file path against your active plugins

• Instant Deactivation: Automatically deactivates the problematic plugin during the shutdown phase

• Protected Plugins Allowlist: Mark critical plugins (for example a checkout or payments plugin) that must never be deactivated automatically — the fatal is still logged and reported honestly

• Log-Only Mode: Optionally detect and log fatal errors without ever deactivating a plugin

• Instant Email & Webhook Alerts: Get notified within seconds of a fatal error — by email and/or a webhook (generic JSON or Slack-compatible) — including which plugin was deactivated, or an urgent warning when a protected plugin is still crashing. Identical repeated errors are rate-limited so a looping fatal can’t flood your inbox or channel

• Protection Watchdog: An hourly background check verifies the protection drop-in end-to-end, silently reinstalls it if it went missing or was overwritten, detects when the plugin folder was moved or fatal error handling was disabled in wp-config.php, and alerts you when protection can’t be restored automatically

• Out-of-Memory Resilience: A small reserved memory buffer lets the plugin log and alert even when the fatal error is PHP running out of memory

• Protection-Status Visibility: Admin warning, status banner with a “last verified” heartbeat, and a Site Health test that tell you when the protection drop-in is missing, replaced, or could not be installed — with one-click reinstall

• Source-Aware Messaging: Detects whether a fatal error came from a plugin, theme, must-use plugin, drop-in, or WordPress core, and reports the source honestly — it never claims to have resolved an error it could not act on

• Detailed Admin Notifications: Provides clear notifications about which plugin was deactivated and why

• Persistent Error Logging: Records every detected fatal error in a permanent log for troubleshooting, even when no plugin could be attributed

• Error Log Management Page: Dedicated admin page with an at-a-glance summary, source labels, and status badges to view, manage, and clear error history

• Filter, Search & Export: Filter the log by source and status, search by plugin/message/file, delete individual entries, and export everything to CSV or JSON — plus one-click copy of a ready-to-paste bug report

• Repeat-Aware Logging: Identical fatals are grouped into one entry with an occurrence count and first/last-seen times, so a looping error can’t bury your history; each entry also records the request URL and PHP/WordPress version

• Zero Configuration: Works right out of the box with no setup required

• Custom Error Page: Displays a user-friendly error page with a reload button instead of the white screen of death

• Debug-Aware Display: Shows detailed error information on the front-end error page only when WP_DEBUG is on and WP_DEBUG_DISPLAY is not disabled (overridable with FPAD_SHOW_ERROR_DETAILS); errors are always logged regardless

• Drop-in Management: Automatically installs and manages WordPress fatal-error-handler.php drop-in

How It Works

This plugin uses WordPress’s built-in drop-in system to provide the most reliable error handling possible. When activated, it:

• Installs a Drop-in: Creates a fatal-error-handler.php file in your wp-content directory

• Monitors for Errors: WordPress automatically uses this drop-in when fatal errors occur

• Captures Error Details: Records the error message, file, and line number during the shutdown phase

• Identifies the Plugin: Matches the error’s file path against your active plugins to determine which plugin caused the issue

• Deactivates Safely: Automatically deactivates only the problematic plugin

• Logs Everything: Stores detailed information about every fatal error in a permanent log for troubleshooting

• Notifies Admins: Displays clear admin notices with error details when you next log in

• Shows User-Friendly Pages: Displays a custom error page with reload button instead of the white screen of death

The drop-in approach ensures maximum reliability since it operates at the WordPress core level, even when other plugins fail.

Use Cases

• Development Environments: Test new plugins without worrying about site crashes

• Production Sites: Add an extra layer of protection against unexpected plugin conflicts

• Managed WordPress: Essential tool for agencies and freelancers managing multiple client sites

• WooCommerce Stores: Prevent revenue loss from site downtime due to plugin errors

Why You Need This Plugin

WordPress fatal errors can make your entire site inaccessible, requiring FTP or hosting panel access to fix. With Fatal Plugin Auto Deactivator, your site remains operational even when a plugin causes a critical error, giving you time to address the issue without emergency measures.