TroubleLens – Conflict Detector

The usual way to find a plugin conflict is to deactivate plugins one at a time and see what changes. On a live site that means taking features away from real visitors and customers while you experiment.

TroubleLens does the same investigation without that cost. It gives you a private troubleshooting session: plugins you switch off stop loading for your requests only. Everyone else — visitors, customers, other administrators, search engines, scheduled tasks — continues to get the site exactly as it is. The list of active plugins in your database is never changed.

How it works

Starting a session writes one small must-use plugin and sets a cookie in your browser. On requests carrying that cookie, WordPress is told a different list of active plugins. That is the only supported way to do this: the plugin list is read before any normal plugin has loaded, so the code doing the filtering has to already be running.

What it does

• Troubleshooting mode. Switch any active plugin off for yourself. Nothing is deactivated.
• Theme test. Render your own session with a bundled default theme while visitors keep the live one.
• Guided isolation. Answer “is the problem still there?” a handful of times and the plugin narrows twenty candidates down to one by halves, then confirms it by switching that one off and on again.
• Diagnostics. REST API, WP-Cron and read-only database checks, plus errors read from the WordPress debug log and grouped by the component they were recorded in.
• WooCommerce checks. Version, required pages, HTTPS, template overrides that have fallen behind, and the scheduled action queue. Only appears when WooCommerce is running.
• Support report. Everything gathered, in text or JSON, with credentials and personal data stripped out.
• Automatic isolation. Describe how to tell the problem apart once and the whole search runs itself, fetching the page through your session after each round.
• JavaScript errors. Recorded in your browser during a session and attributed to a plugin or theme. These never reach the PHP debug log.
• Duplicate libraries. Two copies of jQuery or Select2 on one page, named with both loaders. Found without reproducing anything.
• Where plugins meet. Hooks with callbacks from more than one plugin, and which plugins detach other people’s callbacks.
• Load cost. What each plugin adds to a page, measured by switching it off for your session and reloading.
• What changed. Real version numbers recorded when WordPress updates something, so “it worked yesterday” has an answer.

What it will not do

This is a diagnostic tool, so it does not change things it is measuring:

• It never writes to the active_plugins option, and it prevents anything else from writing it while a session is running.
• It never switches your real theme.
• It never deletes, optimises or repairs anything in the database, and never clears a transient or a scheduled event.
• It never writes to wp-config.php, including to enable WP_DEBUG.
• It never installs its own PHP error handler. It reads what WordPress already records, and states plainly what that misses.
• It never reports a plugin as the cause of anything. It reports what was observed, with the observations attached, and says “strong candidate” where that is what the evidence supports.

Privacy

TroubleLens has no telemetry, no tracking and no advertising, and contacts no third party service. The HTTP requests it makes go to your own site and nowhere else: to your REST API, to check that it answers, and to your own pages, to time them or to see whether a symptom is still there.

There are exactly two exceptions, and each only happens when you press the button that causes it.

The outgoing mail check sends a single message to the email address on your own account, so that a site whose mail is broken finds out before its customers do. It carries nothing about your site beyond its name.

The core file check asks WordPress.org for the list of checksums published for your exact version, and compares the files here against it. All it sends is the version and language needed to identify which list to return. Your own themes, plugins and uploads are never checked, because nobody publishes checksums for those.

Support reports are built and rendered on your server. Nothing is transmitted anywhere; you copy or download the report and send it yourself. Before it is shown to you, passwords, salts, authentication keys, tokens, API keys and payment gateway credentials are removed, email addresses are replaced, and absolute server paths are made relative.