Title: Plug Error Handler
Author: monzur
Published: <strong>juin 2, 2025</strong>
Last modified: juin 2, 2025

---

Search plugins

![](https://ps.w.org/plug-error-handler/assets/banner-772x250.png?rev=3304994)

![](https://ps.w.org/plug-error-handler/assets/icon-256x256.png?rev=3306158)

# Plug Error Handler

 By [monzur](https://profiles.wordpress.org/monzur/)

[Download](https://downloads.wordpress.org/plugin/plug-error-handler.1.0.2.zip)

 * [Details](https://tah.wordpress.org/plugins/plug-error-handler/#description)
 * [Reviews](https://tah.wordpress.org/plugins/plug-error-handler/#reviews)
 *  [Installation](https://tah.wordpress.org/plugins/plug-error-handler/#installation)
 * [Development](https://tah.wordpress.org/plugins/plug-error-handler/#developers)

 [Support](https://wordpress.org/support/plugin/plug-error-handler/)

## Description

**Plug Error Handler** is a lightweight and safety-focused WordPress plugin that
helps prevent white screens or fatal crashes caused by problematic plugins. It does
this by **automatically detecting and deactivating any plugin that throws a PHP 
fatal error or parse error** during activation or update.

It’s designed to ensure a smooth admin experience by intercepting site-breaking 
issues at the moment they occur.

### 🔐 Key Features

 * Detects PHP **fatal errors**, **parse errors**, **compile errors**, and **core
   errors**.
 * Automatically **deactivates the faulty plugin** during activation or update.
 * Displays a clear **admin notice** indicating which plugin caused the issue and
   what type of error it triggered.
 * Lightweight: No database usage (uses transients), no impact on performance.
 * No settings page — works silently in the background for your safety.

### ⚠️ Limitations

 * Only handles **PHP errors** — does **not** detect:
    - JavaScript errors
    - CSS conflicts
    - Plugin conflicts that don’t produce fatal errors
 * Only handles errors during **activation** or **update** (not runtime issues).
 * Designed for **administrator-level users** who manage plugin changes.

### License

This plugin is licensed under the GPLv2 or later. See https://www.gnu.org/licenses/
gpl-2.0.html for details.

## Screenshots

 * [[
 * Example admin notice showing which plugin was deactivated and why.
 * [[

## Installation

 1. Upload the plugin folder `plug-error-handler` to the `/wp-content/plugins/` directory.
 2. Activate the plugin through the ‘Plugins’ menu in WordPress.
 3. That’s it! The plugin runs silently in the background.

## FAQ

### What does this plugin actually do?

It monitors for PHP fatal errors, parse errors, and similar fatal conditions during
plugin activation or update. If such an error occurs, it immediately deactivates
the plugin and prevents your site from breaking.

### How does it detect errors?

It uses `register_shutdown_function()` to catch fatal errors via `error_get_last()`
and uses the `$_GET['plugin']` and `$_GET['action']` values to identify which plugin
was being activated or updated.

### Does it protect from runtime plugin errors?

No. It only works at the time of **plugin activation** or **plugin update**. Runtime
errors (which occur after a plugin has been successfully activated) are not handled.

### Does it protect against JavaScript or CSS errors?

No, this plugin only handles **PHP errors**. It does not analyze or mitigate issues
from JavaScript or stylesheets.

### Will this plugin conflict with other admin plugins?

No. It’s built to be conflict-free and only activates its logic when a plugin is
being activated or updated.

### Can I see logs or history of plugin errors?

No logs are stored to the database to keep this plugin lightweight. You’ll only 
see an **admin notice** if a plugin was automatically deactivated due to an error.

## Reviews

![](https://secure.gravatar.com/avatar/f48ce498e3d87c38bffa7443726d0bf7b3811df56da52affe116dfc82397c442?
s=60&d=retro&r=g)

### 󠀁[Handy tool](https://wordpress.org/support/topic/handy-tool-41/)󠁿

 [bilash2025](https://profiles.wordpress.org/bilash2025/) juin 11, 2025

« Thumbs up! I tested this with two problematic plugins and i found this one working.»

 [ Read all 1 review ](https://wordpress.org/support/plugin/plug-error-handler/reviews/)

## Contributors & Developers

“Plug Error Handler” is open source software. The following people have contributed
to this plugin.

Contributors

 *   [ monzur ](https://profiles.wordpress.org/monzur/)

[Translate “Plug Error Handler” into your language.](https://translate.wordpress.org/projects/wp-plugins/plug-error-handler)

### Interested in development?

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

## Changelog

#### 1.0.2

 * Added support for plugin updates (`update-plugin` action).
 * Improved error handling logic.
 * Fixed text domain mismatch and translation comments.
 * Compliant with WordPress plugin standards and Plugin Checker.

#### 1.0.1

 * Initial public release with fatal error detection during plugin activation.

## Meta

 *  Version **1.0.2**
 *  Last updated **10 mois ago**
 *  Active installations **Fewer than 10**
 *  WordPress version ** 6.6 or higher **
 *  Tested up to **6.8.5**
 *  PHP version ** 7.4 or higher **
 *  Language
 * [English (US)](https://wordpress.org/plugins/plug-error-handler/)
 * Tags
 * [error-handler](https://tah.wordpress.org/plugins/tags/error-handler/)[fatal error](https://tah.wordpress.org/plugins/tags/fatal-error/)
   [plugin conflict](https://tah.wordpress.org/plugins/tags/plugin-conflict/)[safety](https://tah.wordpress.org/plugins/tags/safety/)
 *  [Advanced View](https://tah.wordpress.org/plugins/plug-error-handler/advanced/)

## Ratings

 5 out of 5 stars.

 *  [  1 5-star review     ](https://wordpress.org/support/plugin/plug-error-handler/reviews/?filter=5)
 *  [  0 4-star reviews     ](https://wordpress.org/support/plugin/plug-error-handler/reviews/?filter=4)
 *  [  0 3-star reviews     ](https://wordpress.org/support/plugin/plug-error-handler/reviews/?filter=3)
 *  [  0 2-star reviews     ](https://wordpress.org/support/plugin/plug-error-handler/reviews/?filter=2)
 *  [  0 1-star reviews     ](https://wordpress.org/support/plugin/plug-error-handler/reviews/?filter=1)

[Add my review](https://wordpress.org/support/plugin/plug-error-handler/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/plug-error-handler/reviews/)

## Contributors

 *   [ monzur ](https://profiles.wordpress.org/monzur/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/plug-error-handler/)

## Donate

Would you like to support the advancement of this plugin?

 [ Donate to this plugin ](https://profiles.wordpress.org/monzur/)