How to Test for Plugins Conflict

It is fairly common that plugins and themes conflict with one another. In this guide, we will see:

  • What are  conflicts  and what they look like;
  • How to determine which plugin or theme conflicts with MailPoet;
  • How to resolve them.

What Are Conflicts?

Conflicts happen when a plugin or a theme load different versions of the same script on the same page. There are dozens of popular scripts that allow rich functionality in plugins and themes, for example  jQuery.

Unfortunately, poorly developed plugins and themes load their scripts on all pages in the admin, including MailPoet's. 

MailPoet itself never conflicts with other plugins. It's nearly always the other way around: another plugin or theme conflicts with MailPoet.

Signs of a conflict:

  • MailPoet loads blank pages; 
  • Partially loaded pages or missing options;
  • You cannot save your settings;
  • Clicking on buttons or options does not work;
  • A visitor cannot sign up to your form.

Before you begin

  1. Update all your plugins. Is there still a problem with MailPoet?
  2. Clear your site's cache, if you have this option. Is there still a problem with MailPoet?
  3. Ensure you have a backup of your website. Deactivating plugins doesn't lose your settings, but we cannot guarantee it.

Step by Step Guide To Identify A Conflict

1. Install and activate the plugin Health Check & Troubleshooting in WordPress  dashboard  > Plugins > Add New and search for “Health Check”;

2. Go to  Dashboard > Health Check menu item.

3. Go to the Troubleshooting tab and click on the "Enable Troubleshooting Mode" button.

4. After activating this mode, you - and not your visitors - will see your website with all plugins disabled, and a default theme activated. 

This enables you to reactivate the plugins and/or theme one at a time to see when the problem returns. 

5. Enable MailPoet 3 (New) plugin in the  Troubleshooting Mode first and try MailPoet to see if it works normally with all the other plugins disabled.

6. If MailPoet is still broken, contact us using the link in the top menu of this page or with the form available in the help icon at the bottom right of all your MailPoet pages (preferred).

If MailPoet works normally, great! Continue to the next step.

7.  First  enable your theme in the Troubleshooting Mode menu. Test to see if MailPoet works. 

If MailPoet and your theme don't conflict, enable your other plugins one after the other and test MailPoet each time to see which plugin breaks MailPoet. 

This step should help you identify which plugin or theme conflicts with MailPoet.

8. Disable  Troubleshooting Mode:

How To Resolve A Conflict

You cannot resolve conflicts yourself, unfortunately. But you can:

  1. Keep MailPoet or the conflicting plugin or theme disabled for the time being;
  2. Delete the conflicting plugin if you don't really need it;
  3. Temporarily disable the plugin that conflicts with MailPoet, if it's affecting only one functionality, so you can re-enable it after doing the changes you need.
  4. Contact the author of the plugin or theme and let them know about the conflict.