Troubleshooting & Diagnostics BETA
Common Symptoms
Click the [+] to see more specific symptoms. Click a symptom to see potential diagnoses.
- UberMenu
Symptom Details
UberMenu Troubleshooting Symptoms- Google Maps display issue
Symptom Details
The map is either not displaying, or is not drawn completely. - jQuery/javascript errors
Symptom Details
A javascript error is printed in the javascript console. - [+] Styles don't look like the demo
Symptom Details
Because we're injecting a chunk of HTML into a theme's markup and replacing an existing menu, the theme (or other plugins) CSS styles, javascript, or PHP functions can affect how the menu displays. Generally, themes that are written with modularity in mind don't have this issue.- No animations
Symptom Details
The submenu opens when hovering over a top level menu item, but the animations do not occur. - Menu items completely unstyled
Symptom Details
The menu items are present, but they are not styled at all like a menu - they just display as an unordered list. - Styles present but not like demo
Symptom Details
It is clear that the UberMenu styles are being applied, but they don't look like the demo - this indicates that other styles (from the theme or another plugin) are also affecting the look of the menu.
- No animations
- [+] Submenus (dropdowns) not displaying
Symptom Details
The submenus are not appearing when the top level menu item is activated (hover or click).- Javascript error
Symptom Details
Any javascript error can prevent UberMenu's javascript from running, resulting in the submenu not opening. Javascript errors are displayed in your browser's javascript console. - Submenu partially obstructed
Symptom Details
The submenu can be seen to open, but part of it is hidden behind other elements of the site. - Submenus display but third level menu items are hidden
Symptom Details
The submenus open, but the third level menu items remain hidden until hovering over their parent second level menu items.
- Javascript error
- Internet Explorer display problem
Symptom Details
There is a display issue, specifically in a version of Internet Explorer (IE). - Can't Expand Responsive Menu Toggle
Symptom Details
When you click the collapsed "Menu" button on a mobile device, nothing happens and the menu items are not revealed. - UberMenu does not appear
Symptom Details
UberMenu replaces the existing menu by targeting a theme_location on a specific wp_nav_menu call. Because we're injecting the menu markup into the middle of a theme template, the theme's CSS, javascript, and PHP code can affect the rendering of the menu. - UberMenu and Theme Menu Both Appear
Symptom Details
When using a responsive theme, UberMenu and the theme menu both appear once activating UberMenu. - Menu is not positioned properly
Symptom Details
The menu does not appear in the expected location - Style Generator Color Picker Won't Work
Symptom Details
- Current submenu open by default
Symptom Details
When visiting a page, the submenu of the current menu item opens automatically without it being triggered by the user. - UberMenu appears twice / duplicated
Symptom Details
- Google Maps display issue
Symptom
Can't Expand Responsive Menu Toggle
When you click the collapsed "Menu" button on a mobile device, nothing happens and the menu items are not revealed.
6 Potential Diagnoses
jQuery version incorrect 343
UberMenu 3.0 requires jQuery 1.11.1 or higher (but less than jQuery v2), which should automatically be included with WordPress 3.9 or higher. If your theme or another plugin has changed the jQuery version, that can cause javascript errors that can break the menu as well as other javascript component on your site.
View SolutionUberMenu javascript is not loaded 90
If a WordPress theme does not include the required hooks (wp_footer), UberMenu can’t load its javascript, so javascript functionality like animations, triggers, and maps will be lost.
View SolutionjQuery Enhancements disabled (UberMenu 2 only) 39
If you disable jQuery Enhancements, you will lose all javascript functionality in the menu, including animations, maps, non-hover triggers, and the responsive menu toggle expansion.
View SolutionUnrelated javascript error 44
If another plugin or your theme throws a javascript error before UberMenu’s javascript has been executed, it will prevent UberMenu from functioning properly, including submenu positioning, click events, responsive menu toggling, and more.
View SolutionMenu is obstructed by another element on the page 32
When two elements overlap, one has to be on top. The one on the bottom may still be visible if the top element is transparent, but the bottom element can’t be interacted with because click/hover events are applied to the top level element and are blocked from the one below it.
View SolutionResidual Styling Hides the Mobile Menu 19
In some cases, the theme’s CSS will set the menu to display:none;, which will hide the menu even when the toggle tries to expand it. For full details, please see the Knowledgebase: Residual Styling. Depending on the nature of the issue, you may need to use Manual Integration to prevent the theme from interfering.
View Solution