SuperNav — Documentation

Visual builder, 6 panel types, dimming & panel animation (incl. optional flip), styling, Freemius plans (Launch/Grow/Scale), multilingual and theme integration — as of Core 2.10.56 (card hover color fix, card images/icons, mega-panel stability).

1. Quick start

menu editor with expanded ⚡ SuperNav panel

Open the menu editor

WordPress Admin → Appearance → Menus → select the desired menu

Expand a menu item

Click the arrow on a top-level entry
→ At the very bottom appears: ⚡ SuperNav Panel

Basic settings

FieldValue for a features menu
Panel typeColumns with icons & descriptions
Panel widthWide (~1100px)
"View all" textView all features
"View all" URL/features

Save

Click "Save Menu" at the bottom right — only then do all changes take effect.

Visual builder: Columns, links, icons and badges can be edited via forms — JSON knowledge is optional. The JSON editor remains available for power users (Validate / Format / Load template).

Each menu item offers 6 panel types: Columns with icons & descriptions, Cards with images, Featured image + support links, Content (widgets/shortcodes), Auto (from WP submenu), and Shortcode/HTML.


2. Feature overview (Free)

  • Mega menu panels — multi-column dropdowns per top-level item.
  • Visual builder + optional JSON expert mode.
  • 6 panel types — Columns, Cards, Featured, Content, Auto, Shortcode/HTML.
  • Image swap — right-side image fades on item hover.
  • Icons & badges — Dashicons, highlight badges, global filled/outline style, per-badge "badge_outline": true.
  • Tag row — filter/category pills at the top of the panel.
  • CTA/footer bar — label, links, optional plain_links, right_html.
  • Sidebar groups — text links or image mode (lmm_extra_mode).
  • Bottom links and configurable “View all” link.
  • Responsive / mobile — hamburger, drawer or fullscreen, configurable breakpoint.
  • Theme-independent — any theme using native wp_nav_menu().

3. JSON structure: Columns & Links

The JSON content goes into the "Columns & Links" tab in the menu editor.

Tip: Validate your JSON with the JSON tester before pasting it into the menu editor.

Minimal example (1 column, 2 items)

[
  {
    "heading": "Accounting",
    "items": [
      {
        "label": "Invoices",
        "desc": "Legally compliant and effortless invoicing",
        "url": "/invoices",
        "icon": "dashicons-media-document"
      },
      {
        "label": "Orders",
        "desc": "Create convincing quotes",
        "url": "/orders",
        "icon": "dashicons-email-alt"
      }
    ]
  }
]

Full example (2 columns + badge)

[
  {
    "heading": "Accounting",
    "items": [
      {
        "label": "Invoices",
        "desc": "Legally compliant and effortless invoicing",
        "url": "/invoices",
        "icon": "dashicons-media-document",
        "badge": "E-invoicing · Perfectly prepared",
        "badge_url": "/e-invoicing"
      },
      {
        "label": "Orders",
        "desc": "Create convincing quotes",
        "url": "/orders",
        "icon": "dashicons-email-alt"
      },
      {
        "label": "Receipt capture",
        "desc": "Collect all receipts in one place",
        "url": "/receipts",
        "icon": "dashicons-format-image"
      },
      {
        "label": "Banking",
        "desc": "Book incoming payments automatically",
        "url": "/banking",
        "icon": "dashicons-bank"
      },
      {
        "label": "Contact management",
        "desc": "All info on customers and suppliers",
        "url": "/contacts",
        "icon": "dashicons-groups"
      },
      {
        "label": "Products and services",
        "desc": "Maintain hourly rates and stock",
        "url": "/products",
        "icon": "dashicons-products"
      }
    ]
  },
  {
    "heading": "Taxes and reporting",
    "items": [
      {
        "label": "Overview",
        "desc": "Keep track of finances and tax load",
        "url": "/overview",
        "icon": "dashicons-dashboard"
      },
      {
        "label": "VAT return",
        "desc": "Pre-filled and sent directly to the tax office",
        "url": "/vat",
        "icon": "dashicons-chart-bar"
      },
      {
        "label": "P&L statement",
        "desc": "Effortless profit calculation on the side",
        "url": "/pnl",
        "icon": "dashicons-grid-view"
      },
      {
        "label": "Business evaluation",
        "desc": "Assess your company's performance",
        "url": "/evaluation",
        "icon": "dashicons-chart-area"
      },
      {
        "label": "Trial balance",
        "desc": "Trace journal entries in detail",
        "url": "/trial-balance",
        "icon": "dashicons-list-view"
      },
      {
        "label": "Exports",
        "desc": "DATEV and ADDISON compliant",
        "url": "/exports",
        "icon": "dashicons-download"
      },
      {
        "label": "Collaboration",
        "desc": "With your accountant or tax advisor",
        "url": "/collaboration",
        "icon": "dashicons-share"
      }
    ]
  }
]

4. Configuring colors

🎨 Colors tab in the menu editor

The plugin offers 4 levels of color configuration — from global down to a single item.

Level 1 — Global: plugin settings

WordPress Admin → Settings → SuperNav

Applies to all menu items. Color pickers for every area. No code required.

Level 2 — Per menu item: 🎨 Colors tab

In the menu editor → expand the menu item → tab 🎨 Colors

Overrides the global settings for this menu item only.
Leave empty = the global color is used.

Level 3 — Per column: JSON color fields

Directly in the column's JSON (heading level):

[
  {
    "heading": "Accounting",
    "bg_color": "#f0f9ff",
    "heading_color": "#0369a1",
    "icon_color": "#0369a1",
    "icon_bg": "#e0f2fe",
    "link_color": "#111827",
    "link_hover": "#0369a1",
    "desc_color": "#6b7280",
    "badge_bg": "#0284c7",
    "badge_text": "#ffffff",
    "border_radius": 10,
    "padding": 16,
    "items": [...]
  },
  {
    "heading": "Taxes and reporting",
    "bg_color": "#f0fdf4",
    "heading_color": "#166534",
    "icon_color": "#16a34a",
    "icon_bg": "#dcfce7",
    "items": [...]
  }
]

All column color fields:

FieldDescriptionExample
bg_colorColumn background color#f0f9ff
heading_colorColor of the column heading#0369a1
icon_colorIcon color in this column#0369a1
icon_bgIcon background in this column#e0f2fe
link_colorLink text color#111827
link_hoverLink color on hover#0369a1
desc_colorDescription text color#6b7280
badge_bgBadge (pill) background#0284c7
badge_textBadge text color#ffffff
border_radiusCorner radius of the column in px10
paddingInner spacing of the column in px16

Level 4 — Per item: JSON color fields

Directly on the individual item (items[] level):

{
  "label": "Invoices",
  "desc": "Legally compliant and effortless invoicing",
  "url": "/invoices",
  "icon": "dashicons-media-document",
  "item_bg": "#fef9c3",
  "item_color": "#92400e",
  "item_icon_color": "#d97706",
  "item_badge_bg": "#f59e0b",
  "badge": "NEW",
  "badge_url": "/invoices-new"
}

All item color fields:

FieldDescriptionExample
item_bgBackground color of the item#fef9c3
item_colorText color of the link#92400e
item_icon_colorIcon color of this item#d97706
item_badge_bgBadge color of this item#f59e0b

Priority of color levels

Item JSON > column JSON > 🎨 Colors tab (per menu item) > plugin settings (global)

The most specific one wins — leaving a field empty always means: the next level up is used.


6. CTA bar

CTA bar below the panel (frontend)

The CTA bar appears as a strip at the bottom edge of the panel.

"CTA bar" tab

{
  "label": "Free tools for the self-employed.",
  "links": [
    { "label": "E-invoice generator", "url": "/tools/e-invoice" },
    { "label": "Invoice generator",   "url": "/tools/invoice" },
    { "label": "All free tools",      "url": "/tools" }
  ]
}

7. Method B: directly via HTML

If you want maximum control or use a page builder:

<div class="lmm-panel-columns">
  <div class="lmm-cols-area">

    <!-- Column with background color -->
    <div class="lmm-col lmm-col--colored" style="background:#f0f9ff;--lmm-heading-color:#0369a1;border-radius:10px;padding:16px">
      <p class="lmm-col-heading">Accounting</p>
      <ul class="lmm-col-items">

        <!-- Item with badge -->
        <li class="lmm-col-item lmm-has-badge">
          <a href="/e-invoicing" class="lmm-badge-link">
            E-invoicing · Perfectly prepared
          </a>
          <a href="/invoices" class="lmm-col-link">
            <span class="lmm-col-icon"><span class="dashicons dashicons-media-document"></span></span>
            <span class="lmm-col-text">
              <span class="lmm-col-label">Invoices</span>
              <span class="lmm-col-desc">Legally compliant and effortless invoicing</span>
            </span>
          </a>
        </li>

        <!-- Item with its own background color -->
        <li class="lmm-col-item lmm-item--colored" style="background:#fffbeb;border-radius:8px;--lmm-icon-color:#d97706">
          <a href="/banking" class="lmm-col-link">
            <span class="lmm-col-icon"><span class="dashicons dashicons-bank"></span></span>
            <span class="lmm-col-text">
              <span class="lmm-col-label">Banking</span>
              <span class="lmm-col-desc">Book incoming payments automatically</span>
            </span>
          </a>
        </li>

      </ul>
    </div>

  </div>

  <!-- Sidebar -->
  <div class="lmm-panel-sidebar">
    <div class="lmm-sidebar-group">
      <p class="lmm-col-heading">Extensions</p>
      <ul class="lmm-sidebar-items">
        <li><a href="/integrations" class="lmm-sidebar-link">Integrations</a></li>
      </ul>
    </div>
    <div class="lmm-sidebar-bottom">
      <a href="/invoicing-software" class="lmm-all-link">Invoicing software →</a>
    </div>
  </div>
</div>

8. JSON field reference and tester

Tip: The JSON tester validates all fields of this reference automatically.

Column level ([] array objects)

FieldTypeRequiredDescription
headingStringColumn heading (UPPERCASE in the design)
itemsArrayList of links
bg_colorHexBackground color of the column
heading_colorHexColor of the heading
icon_colorHexIcon color for all items of this column
icon_bgHexIcon background for all items of this column
link_colorHexLink text color
link_hoverHexLink color on hover
desc_colorHexDescription text color
badge_bgHexBadge background for all items of this column
badge_textHexBadge text color
border_radiusNumberCorner radius in px (e.g. 10)
paddingNumberInner spacing in px (e.g. 16)

Item level (items[] array objects)

FieldTypeRequiredDescription
labelStringLink text
urlStringTarget URL
descStringDescription line in gray
iconStringDashicons class (e.g. dashicons-dashboard)
imageStringImage URL (only for the "Cards" panel type)
badgeStringPill text above the item
badge_urlStringTarget URL of the badge
item_bgHexBackground color of this item
item_colorHexText color of this item
item_icon_colorHexIcon color of this item
item_badge_bgHexBadge color of this item

Note: Always write hex colors with #, e.g. "#ef4444". Leaving a field empty ("") or omitting it = the parent color is used.


✓ JSON Tester

Validate and format your panel JSON right here — the editor turns green for valid and red for invalid JSON. No data is transmitted.

Mode:

    Live preview — this is how SuperNav renders this JSON:

    9. CSS variables reference

    All colors can also be overridden directly as CSS variables.
    In Appearance → Theme Editor → style.css or Additional CSS:

    :root {
      /* Navbar */
      --lmm-navbar-bg:      #ffffff;
      --lmm-navbar-height:  64px;
      --lmm-navbar-border:  #e5e7eb;
    
      /* Panel */
      --lmm-panel-bg:       #ffffff;
      --lmm-panel-border:   #e5e7eb;
      --lmm-panel-radius:   12px;
      --lmm-panel-padding:  32px;
    
      /* Colors */
      --lmm-heading-color:  #ef4444;
      --lmm-link-color:     #111827;
      --lmm-link-hover:     #ef4444;
      --lmm-desc-color:     #6b7280;
      --lmm-icon-color:     #ef4444;
      --lmm-icon-bg:        #fef2f2;
      --lmm-icon-size:      20px;
      --lmm-badge-bg:       #6366f1;
      --lmm-badge-text:     #ffffff;
      --lmm-all-link-color: #6366f1;
      --lmm-cta-bar-bg:     #f9fafb;
      --lmm-cta-bar-link:   #6366f1;
      --lmm-overlay-blur:   2px;
    }
    

    10. Plugin settings

    WordPress Admin → Settings → SuperNav

    SettingDescriptionDefault
    Activation modeAll menus or only specific positionsAll menus
    Open viaHover or clickHover
    Open / close delayms until panel opens or closes50ms / 200ms
    ColorsGlobal color pickers for all panels
    Menu bar (Spacing & Shape)Height, background (gradient = Pro/Launch advanced_style), padding, radius, item colors/hover, typography, spacing, borders, divider/glow, alignment, current item, focus color
    Mega panelPadding, CTA padding, radius, column padding, shadow, width (standard/wide/full), min. edge distance, fixed start position, manual offset
    Dimming overlayOn/off, color, opacity %, blur 0–40px, separate open/close durations (0–2000ms, default 280ms). From 2.10.34: also fades when switching directly between menu items. Honors prefers-reduced-motion.off
    Panel fade in/outOwn open/close durations for the panel (0–2000ms, default 180ms each; Free from 2.10.35). Optional flip / 3D fold from top (from 2.10.36, default off) with adjustable flip angle 20–90° (default 70°, from 2.10.39). From 2.10.40: dynamic 3D perspective by panel height. No fade on mobile accordion.180ms / off / 70°
    FlyoutWidth, background, item text/hover for simple dropdowns
    MobileBreakpoint, toggle bar (color/radius/disable), menu colors, item height, drawer style (drawer/fullscreen)
    Default badge styleGlobal filled or outlinefilled

    Seven tabs in the per-item mega panel editor: Columns & Links, Sidebar, CTA bar, Tag row, Featured, Content blocks, Colors (🎨). On narrow boxes the tab bar wraps instead of overflowing.


    11. Theme compatibility

    Lireno theme (lireno-latest)

    The Lireno theme uses its own nav function. The following adjustment is needed in inc/landing-i18n.php:

    // In the function taxbot_landing_wp_main_top_nav_parts()
    // adjust the wp_nav_menu() call:
    wp_nav_menu(
        array(
            'theme_location' => 'main-top',
            'container'      => false,
            'menu_class'     => 'tb-main-top-menu lmm-nav-container',
            'fallback_cb'    => false,
            'depth'          => 3,
            'walker'         => class_exists('LMM_Walker') ? new LMM_Walker() : null,
        )
    );
    

    And at the end of style.css:

    /* SuperNav theme fix */
    ul.tb-main-top-menu.lmm-nav-container {
        display: flex !important;
        align-items: center;
        list-style: none;
        margin: 0; padding: 0; gap: 4px;
    }
    ul.tb-main-top-menu.lmm-nav-container > li.lmm-has-mega,
    ul.tb-main-top-menu.lmm-nav-container > li.lmm-has-dropdown {
        position: relative !important;
        list-style: none;
    }
    ul.tb-main-top-menu.lmm-nav-container > li.lmm-has-mega .lmm-mega-panel {
        position: absolute !important;
        top: 100% !important;
        left: 0 !important;
        margin-top: 4px;
        z-index: 9999 !important;
    }
    ul.tb-main-top-menu.lmm-nav-container > li.lmm-has-mega.lmm-align-right .lmm-mega-panel {
        left: auto !important;
        right: 0 !important;
    }
    

    Other themes

    If the plugin does not respond (panel does not open), check in the theme's functions.php whether wp_nav_menu() sets its own walker. If so, use this AI assistant prompt:

    The WordPress plugin "SuperNav" is not recognized in my theme.
    The theme calls wp_nav_menu() in [FILE] with theme_location '[LOCATION]'.
    Please add the walker parameter:
    'walker' => class_exists('LMM_Walker') ? new LMM_Walker() : null
    and extend menu_class with 'lmm-nav-container'.
    

    12. Common problems

    Panel does not open
    - Panel type set to "No mega panel"? → Change to "Columns with icons & descriptions"
    - Menu saved after the change?
    - Browser console: document.querySelectorAll('.lmm-has-mega').length — must be > 0
    - Plugin settings: set activation mode to "All menus"

    Panel flickers
    - Increase the close delay: Settings → SuperNav → Close delay → 300
    - Check theme CSS for position: static !important on <li>
    - Add the theme fix CSS to style.css (see theme compatibility)

    Icons not visible
    On pages rendering without wp_head(), Dashicons must be included via the theme filter taxbot_landing_lmm_head_html — see troubleshooting for the full code.

    JSON errors (red marker)
    - Only use double quotes ", no single quotes '
    - No comma after the last item in an array
    - Use the { } Format button — it shows syntax errors
    - Or use the JSON tester on this site

    Badge does not appear
    Set at least "badge" (text). "badge_url" is optional and makes the badge clickable.

    Colors not applied
    Check the priority: item JSON > column JSON > 🎨 tab > plugin settings
    Write hex colors correctly with #: "#ef4444" not "ef4444"

    Panel too far right / left
    The plugin detects edge overflow automatically. To force it manually:

    /* Always left-aligned */
    .lmm-has-mega .lmm-mega-panel { left: 0 !important; right: auto !important; }
    /* Always right-aligned */
    .lmm-has-mega .lmm-mega-panel { left: auto !important; right: 0 !important; }
    

    Dimming overlay does not appear even though it is enabled
    Most common cause: a theme with its own hard-coded .lmm-overlay CSS rule (often with !important, sometimes across multiple theme files or static HTML snapshots). In DevTools: does .lmm-overlay get class lmm-visible? Which computed background wins over var(--lmm-overlay-color)?

    Mega panel editor tabs overflow the right edge
    Affects older versions before the wrap fix — update to Core 2.10.35+.


    13. Dashicons reference

    Accounting & finance:
    dashicons-media-document    → document/invoice
    dashicons-bank              → banking
    dashicons-money-alt         → money
    dashicons-chart-bar         → bar chart
    dashicons-chart-area        → area chart
    dashicons-chart-line        → line chart
    dashicons-list-view         → list
    dashicons-grid-view         → grid
    dashicons-download          → export/download
    
    Contacts & people:
    dashicons-groups            → customer groups
    dashicons-businessman       → individual
    dashicons-store             → shop
    dashicons-email-alt         → email/orders
    
    Navigation & system:
    dashicons-dashboard         → overview
    dashicons-admin-tools       → tools
    dashicons-admin-plugins     → plugins/add-ons
    dashicons-randomize         → integrations
    dashicons-smartphone        → mobile app
    dashicons-share             → collaboration
    dashicons-format-image      → receipt capture
    dashicons-products          → products
    dashicons-sos               → help/support
    dashicons-format-chat       → FAQ/chat
    

    Full list: https://developer.wordpress.org/resource/dashicons/


    14. Panel type: cards with images

    cards panel with images (frontend)

    This panel type shows cards with real photos, title and description — ideal for target groups, solutions or industries.

    Activation

    In the menu editor → expand the menu item → Panel type: cards with images

    JSON structure: "Columns & Links" tab

    The cards go into the first array element under items[]. Every card needs an image field with the full image URL from the WordPress media library.

    [
      {
        "heading": "Founding and business phases",
        "items": [
          {
            "label": "For founders",
            "desc": "Start your self-employment with digital accounting right away.",
            "url": "/founders",
            "image": "https://example.com/wp-content/uploads/founders.jpg"
          },
          {
            "label": "For sole proprietors",
            "desc": "Use your time wisely and rely on simple, clear accounting.",
            "url": "/sole-proprietors",
            "image": "https://example.com/wp-content/uploads/sole-proprietors.jpg"
          },
          {
            "label": "For companies",
            "desc": "Keep an eye on your finances and steer your company to success.",
            "url": "/companies",
            "image": "https://example.com/wp-content/uploads/companies.jpg"
          }
        ]
      }
    ]
    
    You must adjust the image URLs — replace the example URLs with your real media library URLs (see "Uploading images" below).

    Without an image: if no image is set, the icon field is displayed as a Dashicon symbol instead. This way the panel can also be used without images.

    Uploading images

    Images come from the WordPress media library:

    1. WordPress Admin → Media → Add New → upload the image
    2. Click the image → copy the URL from "File URL" on the right
    3. Paste this URL into the JSON as "image": "..."

    Recommended image size: 400 × 260 px (16:10 format), JPG or WebP

    "Sidebar" tab — right column with groups

    [
      {
        "heading": "For the self-employed",
        "items": [
          { "label": "For freelancers",      "url": "/freelancers",      "icon": "dashicons-desktop" },
          { "label": "For small businesses", "url": "/small-businesses", "icon": "dashicons-store" }
        ]
      },
      {
        "heading": "Starting a company",
        "items": [
          { "label": "Found an LLC online", "url": "/founding", "icon": "dashicons-flag" }
        ]
      },
      {
        "heading": "By industry",
        "items": [
          { "label": "Trades",       "url": "/trades",      "icon": "dashicons-admin-tools" },
          { "label": "Car workshop", "url": "/car-repair",  "icon": "dashicons-car" },
          { "label": "Gastronomy",   "url": "/gastronomy",  "icon": "dashicons-food" }
        ]
      }
    ]
    

    Bottom links (arrow link at the bottom of the sidebar)

    [
      { "label": "Discover all industries", "url": "/industries" }
    ]
    

    Difference to "columns with icons"

    AspectColumns with iconsCards with images
    ImageNo (icon only)Yes (photo/graphic)
    LayoutHorizontal link listGrid of cards
    Ideal forFeatures, functionsTarget groups, industries
    Number of items5–8 per column2–4 cards
    JSON fieldiconimage (URL)

    16. Multilingual (i18n)

    Tools → Menu translations with loaded keys

    SuperNav multilingual support uses two systems. The translation module is included from plan Grow (also Scale; not in Free/Launch) and provides AI translation, Excel/CSV import/export and freely configurable target languages (ISO-639-1 — commonly DE/EN/FR/IT for Switzerland, but not limited to those).

    Your own API key is required for AI: AI translation uses OpenRouter. Without a key, manual editing and Excel/CSV still work — AI buttons do not. KITech does not provide a key.

    Set up the OpenRouter API key

    1. Create an account at openrouter.ai (or sign in).
    2. Under Keys, create an API key — typically sk-or-…. Ensure your OpenRouter account has credits (billing is on OpenRouter).
    3. In WordPress open: Tools → Menu translations (Grow/Scale). Alternatively: SuperNav settings → Multilingual tab, if the module is embedded there.
    4. In the Language config section, fill in the OpenRouter API Key field.
    5. Set source language and target languages (comma-separated ISO codes, e.g. en,fr,it) and save (button Generate table / save language config).
    6. Success: notice “OpenRouter API key is saved ✓”. Then per-row / batch AI buttons work. Without a key you see “No OpenRouter API key configured”.

    The key is stored as WordPress option ksn_openrouter_api_key (not exposed on the frontend). API calls go to https://openrouter.ai/api/v1/chat/completions only when you actively translate.

    System 1 — translating menu titles (🌐 field in the menu editor)

    For the top-level menu items (e.g. "Features", "Solutions"):

    1. Appearance → Menus → expand the menu item
    2. At the very bottom: 🌐 Translations (optional)
    3. Enter translations directly (e.g. EN/FR/IT):
    🇬🇧 English:  Features
    🇫🇷 Français: Fonctionnalités
    🇮🇹 Italiano: Funzionalità
    

    Save the menu. Leave empty = the WP navigation label (default language) is used.

    System 2 — translating panel contents (Grow+: translation module)

    For all texts inside the panel (column headings, labels, descriptions, badges, CTA …) — from plan Grow upward (also Scale; not in Free/Launch):

    1. WordPress Admin → Tools → Menu translations
    2. Language config: choose source language and enter target ISO codes (e.g. en,fr,it or more such as pl,es)
    3. Select the menu → Load — the module scans all JSON texts from SuperNav panels
    4. Edit texts manually or translate with AI (your own OpenRouter API key in the language config; only when you run a translation)
    5. Optional: export Excel/CSV → edit → import again
    6. Save

    The module automatically creates keys for all texts:

    ContextDE referenceENFR
    0.headingBuchhaltungAccountingComptabilité
    0.items.0.labelRechnungenInvoicesFactures
    0.items.0.descRechtskonform…Legally compliant…Conformément…
    1.headingSteuern und AuswertungTax and ReportingFiscalité et Analyses

    Import/export workflow (recommended for many texts)

    The fastest way to translate all panel texts:

    Export

    1. Tools → Menu translations
    2. Select the menu → Load
    3. Click Excel (.xlsx) or Google Sheets (CSV)
    4. The file is downloaded with all source texts as reference

    Translate

    • AI translation directly in the module (per row or batch) — requires your own OpenRouter API key
    • Or: fill target columns in Excel/Sheets (according to your configured languages)
    • Or: translate the exported file externally (DeepL/ChatGPT) and re-import

    Import

    1. Upload the translated file under Choose file
    2. Select the mode: Merge (keep existing keys) or Replace
    3. Click Import from file
    4. Done — all translations are active immediately
    Tip: After every menu change (new items in the JSON), click Load again and re-export — this way all new texts end up in the Excel file.

    Important: re-scan after menu changes

    If you change JSON contents in the menu editor (new items, changed labels), click Load again in the module to capture the new texts.

    Activating a language

    The language is controlled via the ?lang= URL parameter (or your existing language switcher), matching the configured ISO codes:

    https://example.com/?lang=de   → German (default)
    https://example.com/?lang=en   → English
    https://example.com/?lang=fr   → French
    https://example.com/?lang=it   → Italian
    https://example.com/?lang=pl   → Polish (example of an additional target)
    

    Configuring languages

    Source and target languages are freely selectable in the module (ISO-639-1). Typical presets:

    Market / setupExample targets
    CH (Switzerland)en,fr,it (source often DE)
    DE / ATen or more as needed
    Internationalany ISO codes, e.g. en,fr,it,pl,es

    Overview: what is translated where

    ElementSystemWhere to configure
    Menu titles🌐 fieldMenu editor → menu item
    Panel headingsMenu translations moduleTools → Menu translations
    Item labelsMenu translations moduleTools → Menu translations
    Item descriptionsMenu translations moduleTools → Menu translations
    Badge textsMenu translations moduleTools → Menu translations
    Sidebar linksMenu translations moduleTools → Menu translations
    CTA barMenu translations moduleTools → Menu translations

    18. Dimming & panel animation

    Path: Settings → SuperNav → Mega menus → Spacing & Shape. Dimming and panel animation are two independent effects with their own timings — both are Free (no Pro license required).

    Dimming overlay

    Option: “Dim the rest of the page while a panel is open”.

    • Color and opacity (0–100%)
    • Blur 0–40px
    • Open duration and close duration separately in ms (0–2000, default 280 ms each) — soft opacity transition; 0 = instant. Recommended: 150–400 ms. Honors prefers-reduced-motion.

    Switching between menu items (Core 2.10.34+): When a visitor moves directly from one open mega menu to another (e.g. quick hover from “Features” to “Solutions”), the background dim fades out and back in briefly — instead of staying dark throughout the switch. Uses the same open/close durations as above; no separate setting; automatic when dimming is enabled.

    The plugin drives CSS variable --lmm-overlay-color. Themes must not override .lmm-overlay with a fixed background: … !important or desktop display: none.

    Panel animation (Core 2.10.35+)

    Section “Panel fade in/out” directly under the dimming overlay. The open mega panel / dropdown itself fades in and out (instead of hard show/hide) — independent of the background dim, with its own timing.

    • Open duration: 0–2000 ms, default 180 ms
    • Close duration: 0–2000 ms, default 180 ms
    • 0 = no transition (instant). Recommended: 120–300 ms.

    Applies to mega panels and simple dropdowns alike. On mobile (accordion view) there is intentionally no fade — panels still open/close immediately.

    Flip effect / 3D fold (Core 2.10.36+)

    Optional checkbox in the same “Panel fade in/out” section:

    • “Flip effect: open the panel like a folding board (3D flip from the top instead of a plain fade)” — default: off
    • Uses the same open/close durations as panel animation (0–2000 ms) — no separate flip-only timings.
    • Automatically disabled when the browser/OS has Reduce motion (prefers-reduced-motion) enabled — then normal fade without 3D.

    Flip angle (Core 2.10.39+): number field 20–90°, step 5°, default 70° (CSS variable --lmm-panel-flip-angle). At a full 90°, most of the panel surface stays nearly invisible during the rotation and only “unfolds” at the end — that feels like a sudden jump, regardless of the open/close duration. A smaller angle (e.g. 60–70°) keeps more of the motion visible and makes the animation softer.

    Smooth flip on tall panels (Core 2.10.40+): 3D perspective is calculated per panel from its actual height (instead of a fixed 1400 px). Short and tall menus open equally smoothly.


    19. Admin & developer tools

    • Admin header — logo, version/license status, docs links, Upgrade to Pro.
    • Clear cache — with timestamp of last clear.
    • Reset settings — deletes saved configuration.
    • Safe mode — emergency stylesheet with black/white contrast; shows all mega panels at once. Banner at page bottom while active. Applies to all visitors — use only temporarily for debugging.
    • License management — Freemius (product ID 33524), Free / Launch / Grow / Scale.
    • Per-item panel colors (Colors tab) — optionally override globals for one menu item.

    20. Pro plans: Launch / Grow / Scale

    TierFeatures
    FreeCore (builder, panel types, overlay …) — without translation module
    LaunchSticky menu, custom menu logo, search box, role-based visibility, advanced styling (incl. menu bar gradient)
    GrowEverything in Launch + translation module (AI translation, Excel/CSV import/export, configurable target languages), auto-panels from subpages, map block in content panels (Google Static Maps; placeholder without API key), free custom CSS editor
    ScaleEverything in Grow + white-label (hide plugin branding) + up to 25 websites (Freemius license quota; not unlimited)

    Billing (Freemius, USD)

    Two paths — features per tier are identical; only billing differs. Details & checkout: Upgrade to Pro.

    PathPlanSitesPrice
    Lifetime (one-time)Launch Lifetime1$ 147
    Grow Lifetime5$ 297
    Scale Lifetime25$ 796
    AnnualLaunch1$ 49 / year
    Grow5$ 99 / year
    Scale25$ 199 / year

    Privacy: The free version does not contact external services by itself. The Pro map block requests images from Google Static Maps API (only with your own Google API key). Pro AI translation calls OpenRouter only when you actively translate — and only with the OpenRouter API key you configured.


    21. Version history

    Current plugin release: 2.10.56 (released ). Highlights below — full changelog in the plugin readme.txt. Release dates are package dates (ISO YYYY-MM-DD).

    VersionReleasedChanges
    v2.10.56Root-cause fix: _lmm_panel_colors was saved as [] instead of {} when colors were left empty, permanently “poisoning” the field — PHP now encodes an object; JS self-heals already affected menu items (Free)
    v2.10.55New color field “Card image background (on hover)” in the menu editor under the 🎨 Colors tab (per menu item, not global) — leave empty to keep default #f3f4f6 (Free)
    v2.10.54Child items of a mega-panel parent (e.g. product cards) no longer incorrectly appear on the top menu level as well (Free)
    v2.10.53Card image background transparent by default; gray area only on hover (Free)
    v2.10.52Card image distorted/cropped for square logos (object-fit:covercontain) (Free)
    v2.10.51Card icons invisible (missing font-family: dashicons) (Free)
    v2.10.50Card image was saved in the backend but not shown on the frontend (wrong JSON key) (Free)
    v2.10.49Invisible flyout text fixed (CSS specificity conflict with theme styles) (Free)
    v2.10.48Solute/Elementor bug report: fatal error with empty menu location, duplicate dropdown arrows, invisible mega panel due to stacking-context conflict (Free)
    v2.10.47Fix desktop mega panel: multi-column panels clipped text on the right — .lmm-cols-area gets min-width:0 so columns share available width (Free)
    v2.10.46Fix desktop mega panel: long icon-badge labels were cut mid-word — badges constrained to column width with ellipsis overflow (Free)
    v2.10.45Fix mobile accordion: large gap between menu item and content — drawer links no longer use height:100% of the expanded row (Free)
    v2.10.44Fix mobile accordion: panel as a block under the link instead of a floating flex column; reset desktop top/left/overflow in the drawer (Free)
    v2.10.43Fix mobile drawer: reparent to <body> so theme backdrop-filter/transform cannot shrink the drawer (Free)
    v2.10.42Fix: separate desktop vs drawer menu copies (positioning, flip, sticky); resize listener leak fixed (Free)
    v2.10.41Fix: mega panel no longer bleeds past the right viewport edge (full width without 100vw scrollbar issue; standard/wide shrink when tight) (Free)
    v2.10.40Flip effect: 3D perspective derived from panel height — smooth open on tall menus (Free)
    v2.10.39Adjustable flip angle 20–90° (default 70°) for a softer 3D fold (Free)
    v2.10.38Fix: flip effect was invisible because position correction forced inline transform:none
    v2.10.37Filter lmm_frontend_config for themes without wp_head(); no duplicate lmm-nav-container class
    v2.10.36Optional flip effect (3D fold from top) for panel open; honors prefers-reduced-motion
    v2.10.35Mega panel itself fades in/out; separate panel open/close durations (independent of overlay; Free)
    v2.10.34Dimming overlay also fades when switching between menu items (Free)
    v2.10.33Overlay open/close durations split into two fields
    v2.10.32Overlay fade durations made configurable
    v2.10.31Overlay fades softly on open and close
    v2.10.29Removed leftover debug code (performance; no user-facing change)
    v2.10.26Real Freemius credentials active (product ID 33524)
    v2.10.25Dimming overlay configurable in the backend (was hard-coded before)
    v2.10.16Configurable minimum distance from screen edge for mega panels (Spacing & Shape); full-width stays edge-to-edge
    v2.10.14–15Panel positioning fixed (anchor to menu item, not the whole nav) and edge clamping simplified
    v2.10.13Freemius SDK bundled — active from v2.10.26 with product ID / public key
    v2.10.10–11CTA footer padding; safe default panel width (image-card panels no longer slide off-screen)
    v2.10.3–6Safe-view mode (“I can’t see anything”); universal edge clamp for mega panels
    v2.10.0–13-tier licensing (Launch/Grow/Scale); CTA plain_links and right_html
    v2.9.8Mobile Toggle Designer; Custom CSS editor (Grow+)
    v2.7.0Interactive preview with panel positioning; i18n / translation integration
    v2.6.0License key field; menu alignment; Pro-gated search box
    v2.5.0Tabbed settings (General, Menu Bar, Mega Menus, Flyout, Mobile, Multilingual, Tools)
    v2.4.0Menu bar styling; accessibility improvements
    v2.3.0Admin header quick links; Tools (cache/reset); mobile accordion
    v2.2.0Free/Pro licensing abstraction; per-column/item colors via JSON
    v2.1.0Content panel type; colors tab; keep-open for interactive panels
    v2.0.0Visual JSON builder; robust hover; automatic panel positioning
    v1.0.0Initial release

    SuperNav v2.10.56 — a product by KITech