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.
- [+] 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.
- 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

Diagnosis

wp_nav_menu call uses ‘menu’ parameter

If a theme’s wp_nav_menu() call uses the menu parameter, the critical theme_location parameter will be ignored – and therefore UberMenu cannot target the menu.

Background

When using the wp_nav_menu function, either a specific menu (by ID) or a theme location (associated with a menu) can be passed. However, if both are passed, the menu ID takes precedence.

The Problem

If a theme’s wp_nav_menu() call uses the menu parameter, the critical theme_location parameter will be ignored – and therefore UberMenu cannot target the menu.

Some themes use both the theme_location AND menu parameter. Only the theme_location parameter should be used.

Identifying the issue

You’ll need to find the wp_nav_menu function call and check the parameters that are being passed to it. This function is called in the header.php under normal circumstances, but you may need to do a global search on your theme files to locate it. If the wp_nav_menu call is passed a menu parameter in addition to the theme_location parameter, you’ve identified the issue.

If the theme_location parameter is not present, you have a secondary issue as well.

The Solution

You can either remove the 'menu' parameter that is passed to the wp_nav_menu function, or use Manual Integration (UberMenu Easy Integration if you are using UberMenu 2).