Skip to content

Troubleshooting

Jump to bottom
Jerel Yoshida edited this page Mar 18, 2026 · 1 revision

Troubleshooting

Common Issues

Menu items not loading via AJAX

Symptoms: Sub-menus don't appear on hover.

Solutions:

  1. Check that AJAX sub-menu loading is enabled:

    • Go to Appearance > Mega Menu Ajax
    • Ensure "Enable AJAX Sub-Menu Loading" is checked

  2. Check browser console for errors:

    • Open DevTools (F12)
    • Look for red error messages

  3. Verify nonce is valid:

    • Clear browser cache
    • Refresh the page

Slow navigation (3+ seconds delay)

Symptoms: Clicking menu items takes too long to navigate.

Solutions:

  1. Update to v1.0.14+ - The hybrid prefetch system fixes this issue

  2. Check preload settings:

    • Disable "Preload JS" if not needed
    • Reduce preload delay to 50ms

  3. Clear transients:

    // Add to functions.php temporarily
delete_transient('mega_menu_ajax_preload_*');

  4. Check server response time:

    • Use browser DevTools Network tab
    • Look for slow AJAX requests

Sub-menus not showing on mobile

Symptoms: Sub-menus don't open on mobile devices.

Solutions:

  1. Tap the parent item (not the link) to toggle
  2. Check mobile breakpoint setting
  3. Ensure mobile toggle is enabled

Conflicts with other plugins

Symptoms: Menu doesn't work correctly with other menu plugins.

Known Conflicts:

Plugin Solution
Max Mega Menu Compatible - auto-detected
Elementor Pro Nav Use our Elementor widget instead
WP Rocket Exclude menu JS from deferred loading

JavaScript errors

Symptoms: Console shows JavaScript errors.

Common Errors:

  1. megaMenuAjax is not defined

    • Plugin JS not loaded
    • Check script concatenation settings

  2. AJAX 400 Bad Request

    • Nonce expired
    • Clear cache and refresh

  3. AJAX 403 Forbidden

    • Security plugin blocking AJAX
    • Whitelist mega_menu_ajax_* actions

Styles not applying

Symptoms: Menu appears unstyled.

Solutions:

  1. Clear CSS cache
  2. Check for CSS minification conflicts
  3. Verify frontend.css is loaded: 
    <link rel="stylesheet" href=".../mega-menu-ajax/assets/css/frontend.css">

Debug Mode

Enable debug logging to troubleshoot issues:

  1. Enable WordPress debug mode in wp-config.php:

    define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);

  2. Open browser console (F12)

  3. Look for [MegaMenuAjax] messages

  4. Check wp-content/debug.log for PHP errors

Getting Help

  1. GitHub Issues: Report a bug
  2. Include with your report:
    • WordPress version
    • PHP version
    • Plugin version
    • Browser console errors
    • Steps to reproduce

Clone this wiki locally