Troubleshooting

Panel öffnet nicht

Symptom: Hover/Klick auf den Menüpunkt zeigt kein Mega-Panel.

• Panel-Typ auf «Kein Mega-Panel» gesetzt? → Auf «Spalten mit Icons & Beschreibungen» (oder einen anderen Typ) ändern.
• Menü nach der Änderung gespeichert?
• Browser-Konsole: document.querySelectorAll('.lmm-has-mega').length — muss > 0 sein.
• Plugin-Einstellungen: Aktivierungsmodus auf «Alle Menüs» stellen.
• JSON leer oder fehlerhaft? Ein Panel ohne gültige Spalten wird nicht gerendert — siehe JSON-Fehler.

Panel flickert beim Hover

Symptom: Panel öffnet und schliesst schnell hintereinander.

• Schliess-Verzögerung erhöhen: Einstellungen → SuperNav → Schliess-Verzögerung → 300
• Theme-CSS prüfen: setzt das Theme position: static !important auf <li>-Elemente?
• Theme-Fix-CSS in style.css einfügen — siehe Theme-Kompatibilität in der Dokumentation.

Icons nicht sichtbar

Symptom: Statt Dashicons erscheinen leere Quadrate oder gar nichts.

Auf Seiten, die ohne wp_head() rendern (z. B. eigenständige Landing-Templates), fehlen die Dashicons. Sie müssen über den Theme-Filter eingebunden werden:

add_filter('taxbot_landing_lmm_head_html', function (string $html): string {
    // Dashicons für SuperNav Icons
    $dashicons_url = includes_url('css/dashicons.min.css');
    $ver           = get_bloginfo('version');
    $html .= '<link rel="stylesheet" id="dashicons-css" href="'
           . esc_url($dashicons_url) . '?ver=' . esc_attr($ver)
           . '" media="all" />' . "\n";
    return $html;
}, 5);

Test in der Browser-Konsole:

document.querySelector('link[href*="dashicons"]') ? 'Dashicons geladen' : 'fehlt'

Auf normalen WordPress-Seiten lädt das Plugin die Dashicons automatisch.

JSON-Fehler (rote Markierung im Editor)

Symptom: Das JSON-Feld zeigt eine rote Fehlermarkierung, das Panel bleibt leer.

• Nur doppelte Anführungszeichen " verwenden, keine einfachen ' und keine typografischen „ “ « ».
• Kein Komma nach dem letzten Element in Arrays und Objekten.
• Button { } Formatieren nutzen — er zeigt die genaue Fehlerstelle an.
• Beim Kopieren aus Word/Mail: Text zuerst in einen reinen Texteditor einfügen (Smart-Quotes entfernen).

Badge erscheint nicht

Symptom: Das «Neu»-Badge am Item wird nicht angezeigt.

Beide Felder müssen gesetzt sein: "badge" und "badge_url".

{
  "label": "Rechnungen",
  "url": "/rechnungen",
  "badge": "Neu",
  "badge_url": "/rechnungen/neu"
}

Farben werden nicht übernommen

Symptom: Konfigurierte Farben erscheinen nicht im Frontend.

• Priorität prüfen: Item-JSON > Spalten-JSON > Tab 🎨 > Plugin-Einstellungen. Eine höhere Ebene überschreibt die niedrigere.
• Hex-Farbe korrekt mit # schreiben: "#ef4444", nicht "ef4444".
• Seiten-Cache leeren — Farbwerte landen im gerenderten HTML.

Details: Farben konfigurieren in der Dokumentation.

Panel zu weit rechts oder links

Symptom: Das Panel ragt über den Bildschirmrand hinaus.

Das Plugin erkennt Randüberschreitungen automatisch. Falls nötig, manuell erzwingen:

/* Immer linksbündig */
.lmm-has-mega .lmm-mega-panel { left: 0 !important; right: auto !important; }

/* Immer rechtsbündig */
.lmm-has-mega .lmm-mega-panel { left: auto !important; right: 0 !important; }

Theme-Konflikte

Symptom: Layout bricht, Panel erscheint an falscher Stelle oder hinter anderen Elementen.

• z-index-Konflikt: Header-Elemente des Themes überlagern das Panel. Test-CSS:

  .lmm-mega-panel { z-index: 99999 !important; }

• overflow: hidden auf Header-Containern verhindert die Anzeige — auf visible setzen.
• Für dokumentierte Theme-Fixes siehe Theme-Kompatibilität.

Übersetzungen greifen nicht

Symptom: Trotz eingetragener EN/FR/IT-Texte erscheint Deutsch.

• URL-Parameter prüfen: die Sprache wird über ?lang=en / ?lang=fr / ?lang=it gesteuert.
• Nach jeder Menü-Änderung im Übersetzungs-Modul erneut Laden klicken — neue JSON-Texte müssen neu gescannt werden.
• Import-Modus beachten: Zusammenführen behält bestehende Keys, Ersetzen überschreibt alles.
• Menütitel (Top-Level) werden separat im 🌐-Feld des Menü-Editors übersetzt, nicht im Modul.

Workflow im Detail: Mehrsprachigkeit (i18n).

Nach Update: alte Darstellung

Symptom: Nach einem Plugin-Update sieht das Panel noch aus wie vorher.

• Browser-Cache hart leeren (Strg+F5).
• Seiten-Cache-Plugin leeren (alle Seiten).
• CDN-Cache (Cloudflare etc.) purgen — CSS/JS-Assets werden versioniert, aber HTML kann gecacht sein.
• Bei Optimierungs-Plugins (Autoptimize, WP Rocket): aggregierte CSS/JS-Dateien neu generieren lassen.