All other little handy tips that can’t really fit in any specific category


Photography technique, tutorials and equipment review.


Tips, tutorials and solutions for Windows, Macs, Linux, Servers and Media Centers. Get the very most out of your computer. Resources for all levels from newbies and techies.

Web Design and Development

Tools, tech tips and tutorials for web design and development. Including wordpress plugins and tweaks.

Tools and Productivity

Software, web applications, scripts and tools to make your computing, design, development or networking experience more easier, enjoyable and productive.

Home » General, Tools and Productivity, Web Design and Development

3 Easy Steps to Diagnose WordPress Plugin Problems

As a wordpress plugin developer for the Google Custom Search plugin, I get a lot of queries from users having problems with the plugin. The most common query I get is “I’ve installed your plugin last year, but recently it stopped working. Can you help me?”. I normally take a 3 step approach to diagnosing wordpress plugin problem, but before we get to that, let’s look at why a plugin might have stopped working.

There are there reasons why a wordpress plugin has stopped working:

  1. It is incompatible with your current version of wordpress
    You might have upgraded your wordpress installation to a newer release. WordPress releases fix/updates and upgrades regularly and the new version might not be compatible with the plugin.
  2. Conflict with other plugins
    This is usually the of  most plugin problems where the code in one of your other plugins conflicts with the code in the plugin in question. JQuery conflicts is common cause.
  3. The new version of the plugin is Broken!
    While very uncommon, it can happen. The developer writing the plugin made some changes which has broken the plugin. This might be the case if you have recently updated the plugin. Normally for this situation, you can expect a new update to be available relatively soon with the fixes.

3 Steps to Diagnosing WordPress Plugin Problems

Step 1: Determine if there is a plugin conflict

  1. Disable all plugins except for the one which is broken and check that the plugin now works (if it doesn’t proceed to the Step 2).
  2. Next activate the plugins one at a time until the plugin in question stops working.
  3. The last plugin which was activated is having a conflict with the plugin which you are diagnosing.

Disable all plugins except the one which you are investigating

Step 2: Determine if the current WordPress theme has a conflict

WordPress themes can contain code which conflicts with the plugin. The easiest way to determine this is to:

  1. Switch wordpress theme to the default “Twenty Eleven” Theme. Check if the plugin in question now works. If it does, then the theme which you have is in conflict with the plugin.

Step 3: Determine Error Using Firefox Error Console

If the first two steps did not diagnose the problem, then you need to use Firefox‘s Error Console to see what the plugin error is.

  1. Open the Error Console in a Firefox browser using the shortcut key Cltr-Shift-J.
  2. Then visit your website in Firefox, you should see the error messages in the Error Console

From there you might be able to identify what the error is which is causing the plugin to not work.

What to Do Once the Problem has been Determined

Once you have found the problem, what can you do to fix it?

If it is a conflict with another plugin or theme, then you might want to contact the developer of that plugin or theme to get them to put a fix in. If you did Step 3 and have the error message from Firefox Error Console, sending the error messages to the developers will help them with providing a fix. What I find is that you get a faster response from the developer when you include the error message.

If you’re familiar with a little PHP or javascript coding, you might even be able to go into the code and fix the problem.

The other alternative, is now that you have identified the culprit, you can choose to not use that plugin or theme and find an alternative. Often times, there are multiple plugins providing similar functionality. You just need to search for them at

Edwin Kwan is the founder and editor of Little Handy Tips and Wollongong Fitness. He is also the developer for the Google Custom Search WordPress plugin and Custom About Author WordPress plugin. He also has a keen interest in Photography . Find out more about him here.


Tags: , , , , ,


  • geneva says:

    Hi Edwin, I have an unusual problem. I have two sites listed for the search in my site and only am getting results from one. Have this ever happened before? Might this be that the other site is and the names are similar?
    Thank you 🙂

  • anto says:

    How to place this plugin in nav bar instead of sidebar.?
    To work in the nav bar the plugin has to be activated in the sidebar too, but i dont want to display the plugin in the side bar. Please help.

  • Ayesha says:

    hi, thanks for this very nice and interesting post. 🙂 I like your writing style, it’s quite unique.

%d bloggers like this: