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

Theme’s wp_nav_menu call does not use the theme_location parameter

The wp_nav_menu() call in the theme MUST use the theme_location parameter for UberMenu to be applied to that menu.

Background

The WordPress 3 menu system allows a theme to register theme locations, which allow users to associate a particular menu to be printed at a particular point within a site layout. When the wp_nav_menu call is made within the theme template, the theme_location parameter must be used. This is the only way that UberMenu can target a particular menu – by the theme_location parameter.

The Problem

Some themes do not use the best practice of registering and using theme locations (this is important for theme flexibility). Without a theme_location, UberMenu can’t target that menu. Proper use of the theme_location parameter is a requirement.

Some themes even register a theme location (which means it will display in the Appearance > Menus > Manage Locations screen), but don’t actually use it in the wp_nav_menu function call – in which case the registered theme location is completely irrelevant.

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 not passed a theme_location parameter, you’ve identified the issue.

The solution

You can register your own theme location and pass the parameter properly, or find a theme that properly implements WordPress 3 menus – but the simplest solution is generally just to replace the theme’s wp_nav_menu call with Manual Integration (Easy Integration if you are using UberMenu 2).