Install
This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.
Install straight from GitHub with WP-CLI:
wp plugin install https://github.com/azanumer/wp-troubleshoot-mode/archive/refs/heads/main.zipNo built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
One-click safe mode for diagnosing plugin conflicts — loads WordPress with every plugin disabled except this one, for your browser only. No more renaming plugin folders over FTP to find out which plugin broke your site.
How it works
- Click Safe Mode: OFF in the admin bar (or Tools → Troubleshoot Mode → Enable safe mode).
- Your browser now loads the site with all plugins disabled. Other visitors still see the normal site.
- If the problem is gone, a plugin is the cause. Exit safe mode and re-enable plugins one at a time until the problem returns — the last one you enabled is the culprit.
Safe mode turns off automatically after 2 hours, or the moment you click Exit safe mode.
Why it's safe
- The safe-mode cookie is signed with an HMAC keyed on your site's
NONCE_KEY, and is only issued to admins after a nonce-checked toggle. Nobody can forge it or enable it for someone else. - Safe mode is per-browser: it never affects other visitors, search engines, or logged-out users.
- The plugin stores no options and no database tables.
Features
- Admin-bar toggle available on every screen.
- Tools page with status and a 3-step conflict-hunting guide.
- Developers: the
wtsm_safe_mode_pluginsfilter lets you keep extra plugins (e.g. a debugging plugin) active during safe mode.
Installation
- Upload the plugin folder to
/wp-content/plugins/. - Activate it from Plugins.
- Use the admin-bar toggle or Tools → Troubleshoot Mode.
Requirements
- WordPress 5.0+
- PHP 7.4+
License
MIT — see LICENSE.