FAQ

How do I use Plugin Detective?

Install Plugin Detective. Then from the WordPress admin, you’ll find Plugin Detective under the Tools menu.

Alternatively, you’ll find a Troubleshoot link added to your admin bar. Click this link on any page, admin or front end, to troubleshoot an issue you’re seeing on that page.

I just see errors or a white screen. Can I still use Plugin Detective to troubleshoot what’s gone wrong?

As long as you can still access your hosting account, you can install Plugin Detective via FTP. We’ve included instructions for Manual Installation on the Installation tab.

Once Plugin Detective is installed, head to yoursite.com/wp-content/plugins/plugin-detective/troubleshoot. You’ll be asked to log in with your WordPress username and password just to make sure you have the right permissions and then Detective Otto Bot will step you through troubleshooting just like always.

How does Detective Otto figure out which plugin is breaking my site?

Detective Otto learns from you. While interrogating the different suspects, Otto will check in with you to see if the issue is still happening on your site or not. You just need to answer “Fixed” or “Broken” after Otto makes a change.

Each of your answers provides Otto another clue that he is able to use to narrow down the list of plugins to find just the one that’s causing the problem.

What if it’s not easy to see what’s broken?

There’s no time limit on the clues for Otto. Some issues are more complex than others. You can use the embedded screen Otto provides you to step through several steps to see if the issue appears, or you can even open your site in a new window and step through whatever steps it takes to replicate the problem you’re having. Once you have the answer – minutes or even hours later – you can tell Otto either “Yes, it’s fixed” or “No, it’s still broken”.

Is this faster than me troubleshooting my plugins manually?

Yes, it’s much faster. Robots can be really fast at figuring out puzzles like these, and Detective Otto Bot is no exception. Rather than disabling your plugins one-by-one, Otto can disable groups of plugins, and use your answers to quickly narrow the scope of his investigation using binary search (a fancy robot term for saving you time).

I told Detective Otto that the problem was fixed, so why is he still interrogating suspects?

Likely Otto was interrogating a group of suspects at the time. The clue that the problem was fixed only narrows it down to the suspect being in that group. Give Otto a couple more rounds of interrogation, and he’ll find the exact plugin that’s causing your problem.

Does Plugin Detective work on multisite installs?

No, we don’t support multisite yet. We wanted to get Plugin Detective out there for people to use as soon as possible, but there’s a good amount of work to do before it will support multisite. As you may know, multisite can get a bit complicated.

With a single install, it’s easy to determine which plugins are active and manipulate them. With a multisite, there are network-activated plugins and plugins at the site level. And theoretically Plugin Detective could be run the whole network, or just looking at a single site. And there are permission differences between a network admin and a site admin. So it will take some work for us to support all that. We want to see how much interest there is in supporting multisite, and get some feedback from multisite users to understand what would be most useful for them and how they’d use it.

If you’re reading this, you likely want to use Plugin Detective to troubleshoot multisite installs. Please send us an email ([email protected]) to let us know you’re interested and answer a few questions to help us build this the right way:

Would this just be a tool for you (the network admin)? Or would you want your site admins to be able to run it (and I assume they could only test their site-activated plugins, not disable any that you’ve network-activated?)