We work hard to make our plugins broadly compatible. However, like all WordPress developers we cannot test with every plugin, theme, and server environment out there. Sometimes “conflicts” occur. This happens when code from one plugin or theme conflicts with another plugin or theme. Most problems that arise with WordPress plugins (like The Events Calendar) are actually conflicts.
This tutorial will help you to determine if a conflict is happening, and find out if it is your theme, or which of your plugin(s) are causing it. Carefully following these steps is often essential to finding a solution, because each step can help you quickly narrow down the possible causes of the problem.
Here are the steps:
Test if there is a conflict
Step 1) Switch to the Twenty Sixteen theme. Go to your site’s WP Admin area. In the left-column menu, click Appearance > Themes. You will see the themes available on your site. Move your cursor over the “Twenty Sixteen” theme, and click “Activate”.
Step 2) Disable all plugins except Tribe Events plugins. In the left-column menu of WP Admin, click Plugins > Installed Plugins. You will now see all the plugins you have installed. Click the checkbox next to every one except The Events Calendar, and any Events Calendar addons like Events Calendar PRO. From the Bulk Actions drop down menu, select “Deactivate” and then click “Apply”.
Step 3) Clear your browser cache, and retest. Once you have followed the steps for clearing your browser cache, go into your site and try to recreate the problem you originally noticed. If it is now fixed, that means there was a conflict. The next step is to find the source of that conflict.
Find the source of a conflict
While these steps can be a bit tedious, they are usually necessary for finding the root cause of a conflict. Understanding the cause makes finding a solution possible.
Step 1) Switch back to your original theme, retest. In WP Admin go back to Appearance > Themes. Find your original theme, and click Activate. Try to recreate the problem again. If you can recreate the problem again, you have a theme conflict. If not, continue to step 2.
Step 2) Re-enable your plugins one at a time, retest between each. Return to the WP Admin > Plugins > Installed Plugins page. Find one of the plugins that you have disabled and click “Activate”. Now try to recreate the problem again. If everything works, try this step again but Activate a different plugin. If the problem has reappeared, you have a plugin conflict. Make a note of which plugin you activated that causes the problem to reappear.
Look for a solution
Once you’ve identified what is causing the conflict, you can look for a solution. If you want help and have purchased premium support for your plugin, please post to our help desk. To help us assist you as quick as possible please include as much information as you can. For instance:
- State that you have found a conflict, and give the name of the conflicting plugin/theme along with its version number.
- Describe in detail the problem that happens when you are running that plugin/theme with a given Tribe plugin.
- If possible, privately post a copy of your System Information from the WP Admin > Events > Help: System Information box.
The following is a list of things that frequently cause conflicts. This is especially helpful for those who have not purchased a plugin which includes premium support, or who simply wish to research the problem on their own.
- Known issue: Some problems have been documented by others as well. To find out if others are experiencing the same issue, try using our search box or even Google. Sometimes others have already found a fix that you can use, or we have helped someone with the same problem at our help desk.
- Theme Override: Do you have any theme overrides? Try disabling them by renaming your [themename]/tribe-events/ folder to ‘tribe-events-bak’.
- Out-of-date Plugins/Theme/WordPress: Are all of your plugins, your theme, and WordPress itself up-to-date? You especially want to run the latest version of Modern Tribe plugins, as we often release compatibility fixes. While new is not always better, the latest versions of everything usually result in the best compatibility.
It is our sincere hope that this tutorial has helped you. Thank you for reading!