How to Test for Theme and Plugin Conflicts
How to identify 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.
Why do they happen?
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, some plugins and themes load their scripts on all pages in the admin, including MailPoet's.
- We strongly recommend that our Premium members use the latest version of the plugin, which is always available for free. Previous versions may have issues, which we won’t support.
- We do not guarantee that the MailPoet plugin will work with other plugins. Plugin conflicts are common and we try our best to avoid any issues with other popular plugins.
How to determinate which plugin or theme conflicts with MailPoet?
Before you begin:
- Update all your plugins. Is there still a problem with MailPoet?
- Clear your site's cache, if you have this option. Is there still a problem with MailPoet?
- 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. In your WordPress admin, go to Tools > Site Health > Troubleshooting and click on "Enable Troubleshooting Mode" :
If you have an older version of WordPress, you need to install and activate the plugin Health Check & Troubleshooting in WordPress
3. 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.
4. 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.
5. 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.
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.
7. Disable Troubleshooting Mode:
How to resolve a conflict?
You cannot resolve conflicts yourself, unfortunately. But you can:
- Keep MailPoet or the conflicting plugin or theme disabled for the time being;
- Delete the conflicting plugin if you don't really need it;
- 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.
- Contact the author of the plugin or theme and let them know about the conflict.