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
Styles don't look like the demo
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.
Have a more specific symptom?
No animations (5)
The submenu opens when hovering over a top level menu item, but the animations do not occur.
View 5 potential diagnoses for this symptomMenu items completely unstyled (4)
The menu items are present, but they are not styled at all like a menu - they just display as an unordered list.
View 4 potential diagnoses for this symptomStyles present but not like demo (3)
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.
View 3 potential diagnoses for this symptom11 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 SolutionUberMenu stylesheets not loaded 6
If a WordPress theme does not include the required hooks (wp_head), UberMenu can’t load its stylesheets, so the menu won’t be styled.
View SolutionInternet Explorer stylesheet limit reached 47
Internet Explorer can only load 31 stylesheets per page. If your theme or another plugin is loading a large number of stylesheets, and the limit is reached before UberMenu’s stylesheets are loaded, UberMenu’s styles will not appear at all in Internet Explorer, because IE has ignored those stylesheets entirely.
View SolutionResidual styling from the theme is affecting the menu display 22
If your theme’s menu styles are based on a hard-coded element wrapping the menu, those styles will still apply after replacing the menu markup, and will conflict and negatively impact the style and functionality of the menu.
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 SolutionUberMenu stylesheets disabled 5
If the basic.css file has been disabled in the Control Panel, the menu will not function properly if the styles have not been included elsewhere.
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 Solutionwp_nav_menu output is filtered or manipulated by theme 3
Some themes will manipulate the UberMenu output in a non-standard way, resulting in breaking the menu style, layout, and functionality, as the markup is not as expected.
View SolutionResidual scripting from the theme 53
Some themes’ menu javascript will still affect the menu even after UberMenu has replaced the default menu. As a result, UberMenu can appear distorted, the styles can be incorrect, extra markup may be added, and the functionality may break.
View SolutionUsing $ outside of a closure ($ is not defined or is not a function) 8
When you’re using a modular system like WordPress, it’s important that all jQuery is compartmentalized and running in noConflict mode in order to avoid conflicts. When other themes/plugins don’t follow this standard, you’ll get jQuery errors that break other scripts, like UberMenu.
View SolutionMenu Item Classes have been stripped 7
Sometimes, a theme or plugin will use a filter to strip out the standard WordPress menu item classes like menu-item
. When these are removed, UberMenu’s styles, which rely on these classes, cannot be applied. Themes and plugins should never remove core functionality.