Giuliomax Menu Builder

Журнал змяненняў

3.8.2

• New: Live phone preview in Mobile tab — the Mobile settings tab now shows a sticky phone mockup on the right that updates in real time as you change any mobile setting (open style, overlay color/opacity, hamburger color/alignment, link color, drawer width, fullscreen alignment)

3.8.1

• Fix: Sub-screen visible on desktop — li.menux-mega-subscreen-li is now hidden globally (display:none!important) and only revealed inside the mobile context, so it never appears as a stray list item in the desktop nav bar
• Fix: Dark screen on mobile open — replaced the transform + pointer-events approach with display:flex + @keyframes animation; the sub-screen is invisible until explicitly opened, eliminating the full-screen dark flash
• Fix: Text invisible on dark overlays — when mobile_link_color is not configured and the menu uses fullscreen or drawer style, the sub-screen text now defaults to #ffffff instead of #374151
• Fix: Back button animation — closing the sub-screen now triggers a slide-out animation (menux-ss-closing) with a 300 ms cleanup timeout; the whole menu closing removes both classes instantly with no animation
• Fix: Sub-screen menux-ss-closing class not cleaned up — bmCloseMenu() now removes both menux-ss-open and menux-ss-closing and clears the pending timer to prevent stale state on reopen

3.8.0

• New: Mobile mega menu push-navigation — tapping a mega menu item on mobile now slides in a dedicated full-screen panel showing only those links, with a ← back button at the top (like mediaworld.it / euronics). This replaces the accordion approach entirely, giving a native app feel and eliminating all font, alignment and bullet-point inconsistencies
• Fix: Dropdown indicator on mobile — the ▾ chevron is replaced with a right-pointing › arrow, correctly signalling push navigation rather than expand-in-place
• Change: Mobile Layout option — the “2-column grid” choice has been removed; the setting now has two values: “Visible on mobile” (push-screen) and “Hidden on mobile”

3.7.1

• Fix: Mobile mega menu polish — removed the stray focus box that appeared around a section heading after tapping it (the keyboard focus ring is preserved for accessibility); forced all mega links and headings to align left on mobile regardless of the per-column alignment set for desktop; mobile mega links now show just their icon + label (the secondary description is hidden) for a cleaner, lighter list

3.7.0

• Fix: Mega menus were unreadable on mobile — preset colours and formatting (designed for a coloured desktop panel) leaked onto the mobile view, producing broken, often unreadable combinations (e.g. light text on the transparent mobile list). On mobile the mega panel is now fully neutralised: no preset background, shadow, radius, fonts or colours — links read like the rest of the mobile menu, using the standard submenu link colour
• New: Mobile mega menu is now a clean nested accordion — tapping a mega menu item expands it; inside, each section heading becomes a tappable sub-accordion that reveals its own links. Sub-sections start collapsed for a compact, easy-to-scan list. Links placed without a section heading stay always-visible at the top. Full keyboard support (Enter/Space) and ARIA expanded state included
• Improvement: Per-panel and per-item appearance now applies on desktop only — the visual Appearance overrides remain exactly as designed on desktop, while mobile always falls back to the neutral, readable accordion
• Improvement: CSS cache is now version-aware — a plugin update immediately serves freshly generated CSS instead of waiting for a settings save or the 24-hour cache expiry
• Housekeeping: Removed the redundant Global Default Colors section from the Mega Menu panel — the per-item 🎨 Appearance tab already covers panel background and all mega colours

3.6.1

• Fix: Mega editor Appearance tab trapped the user — switching to the Appearance tab hid the entire toolbar including the tab buttons themselves, making it impossible to return to Content and causing the live preview to disappear; the toolbar is now always visible and only the column-editing tools are hidden when Appearance is active
• New: Per-panel Max Width — the Appearance tab now includes a “Panel Max Width (px)” field (400–2400); when set, the mega panel box is constrained and centred via max-width + margin: auto, overriding any global inner-content cap; leaving the field empty falls back to full-width behaviour
• Fix: Fatal parse error in help-content.php — an unescaped apostrophe inside a single-quoted PHP string caused a parse error that crashed the entire WordPress admin; apostrophe now correctly escaped (doesn\'t)
• Improvement: Delete button visibility — the item delete button in Menu Structure was nearly invisible against the white background; it is now shown in red at rest and deepens on hover, making destructive intent immediately clear
• Improvement: Drag handle affordance — the drag handle icon in Menu Structure now shows a coloured highlight on row hover and a short “Grab the handle to reorder” label, making the reorder mechanic discoverable for first-time users

3.6.0

• New: Scroll Spy — automatically highlights the nav link for the section currently visible in the viewport as the user scrolls; activate in Style → Layout → 🎯 Scroll Spy; set a trigger offset (default 80 px — sticky bar height is added automatically at runtime); enable smooth scroll with History API hash updates and ARIA live region announcements for screen readers; the last section always activates when the page is scrolled to the very bottom; active section links share the visual treatment defined in the Colors → Active Link tab
• New: Responsive Mega Menu Mobile Layout — a three-mode selector replaces the old “Disable on mobile” checkbox in the Mega Menu panel: Stacked List (all columns merged into a tappable accordion, same behavior as before), 2-Column Grid (columns kept side-by-side in a CSS grid — ideal for category or product menus), or Hidden (panel not rendered on mobile); existing menus automatically retain their previous behavior via back-compat migration
• Improvement: 8 new mega menu presets (20 total) — the preset picker now ships 20 industry templates: SaaS, E-Commerce, Agency, Restaurant, Travel, Healthcare, Real Estate, Law Firm, Finance, Fashion, Hotel, Nonprofit, Events, Automotive, Gaming, Fitness, Beauty & Wellness, Tech Startup, Portfolio, and Education; load any preset in one click from the 🎨 Appearance → ✨ Presets tab
• Improvement: Global mega menu color defaults — a new Color Defaults section in Mega Menu → Appearance lets you set site-wide default colors for mega panel links, headings and accent/icons; per-item overrides remain possible from the individual Appearance tab
• Improvement: Enforce contrast on active links — a new checkbox in Colors → Active Link forces a WCAG-compliant contrast ratio between the active link text and its background; a live badge shows the ratio and WCAG grade (AA / AAA / Fail) as you pick colors
• Improvement: Style panel tab state preserved after save — the open tab (Colors, Typo, Layout…) is no longer reset to Themes after saving; the previously active tab is re-selected automatically
• Improvement: Onboarding tutorial overhauled — expanded from 5 to 11 steps, one per major admin section (Structure, Logo, Mega Menu, Themes, Colors, Typography, Layout, Mobile, Announcement, Search, WooCommerce), each with concrete action guidance
• Improvement: Color picker opacity restored on re-enable — re-checking a color field’s enable checkbox now restores the picker at its last saved opacity instead of snapping back to 1.0
• Fix: Device visibility condition — the PHP save handler now correctly handles separate ‘mobile’ and ‘tablet’ condition values via wp_is_mobile(); previously ‘tablet’ was treated identically to ‘mobile’ at the database level, leading to inconsistent behavior
• Fix: Conditional roles blocked logged-out users — items with Visibility set to “logged-out only” AND a Roles condition set were incorrectly hidden for guests; the roles check is now gated behind is_user_logged_in() so it never runs for unauthenticated visitors
• Fix: CSS cache transient had no expiry — set_transient('menux_css_cache') was called without an expiration argument, potentially allowing stale cached CSS to persist indefinitely after design changes; now expires after 24 hours
• Fix: Import — mega_style, mega_mobile_layout and scroll spy settings not sanitized — these five keys were silently dropped during configuration import; all are now sanitized and preserved correctly

3.5.0

• New: CTA Button style per item — enable the 🎯 CTA toggle on any menu item and choose its background, text color, hover color and border-radius; the link becomes a styled call-to-action button without touching your theme’s CSS; settings are saved per item and survive export/import
• New: Import from WordPress Menus — a new “📋 Import WP” tab in the builder lets you choose any menu created in Appearance → Menus and import all its items (pages and custom links, with one level of sub-items) into the MenuX builder in one click; a confirmation prompt prevents accidental overwrites
• Improvement: Mobile hamburger always transparent by default — !important guards on background, border, appearance and box-shadow prevent theme CSS from accidentally turning the button grey or black; custom background colors also get !important so they actually apply
• Improvement: Mobile text colors — three new color fields (Normal, Hover, Active) in the Style → Hamburger section let you control the link text color inside the mobile menu independently of the desktop menu; empty = inherits theme/menu colors
• Fix: Close button (✕) colors now work on all themes — the fallback was color:inherit, which on many themes resolved to the <button> default (often near-black on dark overlays); replaced with an explicit #333333 default and added !important guards so the color and background settings are always respected
• Fix: Sticky header on mobile no longer clips the hamburger — adds padding-top:8px; padding-bottom:8px inside the mobile media query for .menux-sticky-fixed, giving the button breathing room
• Fix: Mega menu resize listeners accumulated per item — every mega menu item added its own window resize handler; now a single handler per nav covers all open panels
• Fix: Mega menu outside-click handler duplicated per nav — with multiple [menux] shortcodes on one page, every click fired N handlers; now a single guarded document handler covers all navs
• Fix: Close button (✕) now returns focus to the hamburger — clicking the close button in fullscreen/drawer mode now moves focus back to the hamburger, matching the Escape key behavior and fixing a WCAG 2.4.3 violation
• Fix: Mega panel sub-links now close the panel on mobile — tapping a link inside an open mega panel previously left the panel visible behind the destination page; the panel now closes immediately on link click

3.4.0

• New: 50 preset themes with filterable style categories — the Themes panel now offers 50 professionally designed themes (up from 20), organized into 10 style categories: 🌙 Dark, ⚪ Minimal, 🌈 Vibrant, 🎨 Creative, 💼 Corporate, 🌿 Nature, 💎 Elegant, 📼 Retro, 🧊 Glass, 🎈 Playful; a row of interactive category chip buttons above the grid lets you narrow the theme list instantly — each chip shows the number of themes it contains; 30 new original themes added including Obsidian Gold, Graphite Ice, Neon Synthwave, Holographic, Miami 80s, Burgundy Velvet, Frosted Aqua, Bubblegum, Vaporwave and more

3.3.2

• Fix: Announcement Bar width and gap — the bar is now wrapped in a shared flex-column container with the nav, so it always matches the menu width exactly and sits flush against it with no white-space gap, regardless of the theme layout
• Fix: PHP fatal error on admin pages — an unescaped apostrophe in help-content.php caused a parse error that crashed the entire WordPress admin; fixed by escaping the offending character (bar\'s)
• Fix: Announcement Bar section missing from help modal — the 📢 Announcement panel was not documented in the contextual help; a full section covering all fields (message, link, colors, position, dismissal, countdown timer) has been added
• Improvement: Help modal display instructions — the “How to display the menu” entry now leads with the native MenuX block (no-code path) instead of the shortcode

3.3.1

• New: Countdown Timer in Announcement Bar — attach a live ticking countdown (days / hours / minutes / seconds) to any announcement; set a target date/time, a label (e.g. “Ends in:”) and an optional expired message; initial values are rendered server-side to eliminate first-paint flash; the days segment hides automatically when it reaches zero
• Fix: Stale open-state on mobile after closing the menu — second-level and third-level submenus that were open before the hamburger close remained visually open on the next open; bmCloseMenu() now collapses all nested .mobile-sm-open links and resets mega-menu .menux-open state including aria-expanded
• Fix: Accordion not fully collapsing sibling branches — closing a sibling item on mobile only removed the direct-child open class; now clears all descendant .mobile-open / .mobile-sm-open in the sibling branch so deeply nested submenus are fully reset
• Fix: Sticky spacer height drift when web fonts load late — when a Google Font was configured and the page was scrolled before the font finished loading, the spacer kept the wrong height permanently; the new recalcMetricsForce() function briefly removes the fixed class synchronously (no visual flicker) to re-measure, called on document.fonts.ready and on resize

3.3.0

• New: Announcement Bar — add a full-width promotional banner above or below the navigation from MenuX → Announcement in the admin sidebar; configure text, link, background color, text color, font size, vertical padding and position; optionally make it dismissible with a configurable expiry (localStorage); the bar renders exactly once per page even when multiple [menux] shortcodes are present; settings are included in Import/Export

3.2.1

• New: Mobile accordion mode — a new toggle in the Mobile panel (“Close other submenus when one opens”) collapses sibling submenus at the same level whenever a new one is opened on mobile; works for all nesting levels and all mobile opening styles (dropdown, fullscreen, drawer)

3.2.0

• New: Dropdown Indicator customization — choose between Triangle (▾), Chevron (⌄), Dot (•) or None for the arrow shown on items with submenus; set a custom color, size (6–24 px) and toggle the open/close rotation animation. Applies to all levels: top-level items animate on hover or mega-panel open, nested items rotate when their sub-submenu opens. Settings are included in Import/Export.

3.1.3

• Fix: Sticky spacer height stale after Google Font load — when a Google Font was set, the font swap could change the nav height slightly after the initial measurement; document.fonts.ready now triggers a re-measure so the spacer is always the correct height when sticky first engages
• Fix: Duplicate HTML IDs with multiple shortcodes on same page — using [menux] twice on the same page produced duplicate id attributes (menux-nav-main, menux-spacer, menux-list-main, menux-progress-bar); the shortcode now applies the same per-instance suffix strategy already used by the Gutenberg block

3.1.2

• Fix: Overlay and Escape key fire multiple times with multiple nav instances — the overlay click and document Escape listener were registered once per nav element on the page; both are now bound exactly once and dispatch to all nav instances, so pressing Escape or clicking the backdrop always closes the correct open menu
• Fix: Search results XSS with HTML in page text or menu labels — page text containing <, > or & characters was inserted into search result HTML without escaping, potentially breaking layout or allowing injected markup; all text piped through bmSmHL is now HTML-escaped before the <mark> replacement
• Fix: Search “No results” display with special characters — the user’s query string was inserted raw into the “No results for …” message; it is now escaped before rendering
• Fix: Admin language list XSS — language codes and labels returned by the multilingual-plugin AJAX endpoint were inserted into innerHTML without escaping; menux_esc() is now applied to both values

3.1.1

• Fix: Scroll Progress Bar settings were never saved — enabling the progress bar and setting its color, height or position had no effect because the save handler dropped these four fields; they are now persisted and survive import/export
• Fix: Sticky “Shrink on scroll” and “Transition duration” were never saved — both sticky options were rendered in the form but silently discarded on save; now persisted and included in import/export
• Fix: Mega menu shortcode/widget columns — shortcodes that output forms, iframes or inputs (e.g. Contact Form 7, video embeds) were being stripped by output sanitisation; trusted admin shortcode output now renders intact while the surrounding markup stays sanitised
• Fix: Mega panel overflow escape (Elementor) — the page-builder overflow workaround is now ref-counted across sibling mega items and correctly released when a panel is closed by clicking outside or via keyboard, so wrappers are never left with permanently broken clipping
• Fix: Staggered entrance animation — menus with more than 20 top-level items no longer leave the items beyond the 20th permanently invisible
• Fix: Sticky spacer height — the sticky placeholder height is now re-measured on resize and font reflow, preventing a content jump when the bar engages
• Fix: Per-item mega Appearance editor — picking a background no longer wipes unsaved padding/gap/colour edits; every Appearance field now updates the live preview immediately, and the preview honours the per-item border radius and divider style
• Fix: In-page search — clicking a specific result now jumps to that match instead of snapping back to the first; repeated searches no longer fragment the page text
• Internal — aligned the mobile overlay opacity default (0.9) across all layers; removed a per-render document click-listener leak in the mega editor

3.1.0

• Elementor compatibility — mega menu panels now correctly escape Elementor columns that use overflow:hidden; the JavaScript walks up the DOM on open and restores overflow values on close, so the panel is fully visible and receives mouse events correctly
• Entrance animation z-index fix — themes with CSS entrance animations (Indigo Pulse: slideDown, Cosmic Dusk: fadeIn, Violet Cloud, Aurora Night, Ocean Electric, Cloud Glass) no longer trap the mega panel inside a stacking context; changed animation-fill-mode from both to backwards so no transform/opacity is retained after the animation ends, and added an animationend listener to remove the animation rule entirely
• Nav bar right padding — WooCommerce cart icon and search icon no longer sit flush against the right edge of the menu bar; the container now applies the same horizontal padding on the right side as the link items use internally (minimum 8 px)
• Mega menu border-radius — per-item border-radius now applies only to the two bottom corners of the panel, eliminating the visual gap between the nav bar and the panel top edge

3.0.0

• Per-item mega menu appearance — each mega menu now has its own independent 🎨 Appearance tab inside the editor modal with full control over: background (solid color, 12 gradient presets or a custom gradient builder with direction selector and two color pickers), padding top/bottom, padding left/right, column gap, border radius, font size, link color, heading color, accent/icon color, link hover color, description color, divider color and divider style (solid/dashed/dotted); settings are saved per item and generate scoped CSS so each mega menu panel renders with a completely independent look; a “↺ Reset to global defaults” button clears all overrides for that item
• Redesigned Mega Menu admin panel — the item list now shows clear ON/OFF status badges (green ⚡ ON / grey OFF) for each first-level nav item; items in OFF state show a dashed “＋ Enable Mega Menu” call-to-action button; items in ON state show the “⚡ Edit Columns ▶” primary button, a Full Width checkbox and a “✕ Disable” link; the editor modal adds 📋 Content and 🎨 Appearance tab buttons in the toolbar for switching between the column editor and the per-item style panel
• Sidebar reorganisation — ⚡ Mega Menu moved into the Structure group (alongside Menu Structure) since it configures what is in the menu, not how it looks; 🖼️ Logo moved into the Style group (below Colors) since it is a visual/brand setting; ✨ Themes added as a first-class sidebar entry at the top of the Style group for immediate discoverability
• Themes panel accessible directly from sidebar — clicking ✨ Themes in the sidebar now opens the theme grid immediately without requiring a form save first; buildInlineThemeGrid() is called both on DOMContentLoaded and on every navigation to the Themes section
• Descriptive empty-menu state — the builder sidebar empty state now shows a helpful message with a clickable link (“→ Go to Menu Structure”) rather than just “Empty menu”
• Live preview empty state — the live preview also shows an informative message referencing Menu Structure when no items have been added

2.12.0

• New: Duplicate Column button in the mega menu editor — clone any column (including all its items) and insert it right after the original; disabled automatically when the 4-column maximum is reached.
• New: Column text alignment controls (L / C / R) in the mega menu editor — set per-column alignment for links and headings; stored as a column-level property and rendered via data-align CSS selectors.
• New: Mega menu divider color and style settings — choose a custom color for column dividers and headings border, and select between solid, dashed or dotted line styles.
• New: Mega menu open/close animation speed control — configure the panel transition duration (0–800 ms) from the Panel Appearance settings.

2.11.0

• New: Dedicated Mega Menu text styling, independent from the main Colors section — separate controls for heading, link, link hover and description colors, plus the existing panel background.
• New: Per-item heading and link color overrides in the mega menu editor (alongside the existing description color).
• Improved: All 12 mega menu preset templates now ship with professional, high-contrast color palettes tuned to each template’s panel background, so they look polished out of the box regardless of the theme or main menu colors.
• Fix: Mega menu text no longer borrows colors from the main navigation; applying a preset now also applies its colors end-to-end.

2.10.0

• WooCommerce integration — adds a cart icon to the menu with a live item-count badge, an optional cart subtotal, and a mini-cart dropdown showing the current cart contents; the count, total and mini-cart refresh instantly when products are added, with no page reload, via WooCommerce’s native add-to-cart fragments
• Cart icon options — choose between cart, bag or basket icons; place the cart on the left or right of the menu; customise the icon and count-badge colors; optionally hide the cart while it’s empty
• Mini-cart behavior — open the dropdown on hover (with automatic tap-to-open on touch devices), on click, or disable it so the icon links straight to the cart page; closes on outside-click and Escape
• Multi-instance & block safe — every cart icon on the page (header, footer, multiple Gutenberg blocks) updates together; works in classic themes via the shortcode and in FSE themes via the giuliomax/menu block
• Graceful fallback — when WooCommerce is not installed the feature stays completely silent; the settings panel remains available and shows a notice
• Import/Export parity — the new cart settings are included in configuration export and restored on import

2.9.0

• Native Gutenberg block (giuliomax/menu) — adds a dynamic block registered via register_block_type() + block.json; the render_callback delegates entirely to the existing menux_render_shortcode() function so no HTML is duplicated; the shortcode, WP Menu Integration and all other existing features are completely unchanged
• FSE / Site Editor support — the block works in Full Site Editing themes (e.g. Twenty Twenty-Five): drag it into any header template part from the Site Editor; the enqueue_block_editor_assets hook ensures Font Awesome 6, the configured Google Font, and the dynamic theme CSS are loaded inside the editor’s iframe; the mega-menu and hamburger JS initialise correctly in the template-preview iframe
• InspectorControls sidebar — a SelectControl in the block sidebar lets you pick the menu location (Primary, Footer, Sidebar, Mobile); live preview updates via ServerSideRender using the REST block-renderer endpoint
• Multi-instance ID safety — when two or more giuliomax/menu blocks appear on the same page, structural element IDs are automatically suffixed with a unique instance counter
• No new build toolchain — the editor script is plain vanilla JS registered directly via wp_register_script(); no @wordpress/scripts, Webpack or npm required

2.8.0

• Sticky mirror — new “Match main menu” toggle (on by default) makes the sticky bar inherit all styles from the main menu automatically; custom options shown when mirror is disabled
• Container border-radius — new field in Layout → Spacing to round the corners of the menu container
• Page Load Animation — renamed from “Entrance Animation” with improved UX; duration/delay/stagger controls hidden when “None” is selected
• Logo in live preview — the admin live preview now shows the configured logo at the correct position; updates immediately without a save
• Mega Menu preset modal — the template grid was clipped after the first row; the grid wrapper now scrolls independently so all 12 templates are reachable

2.7.0

• Help & Documentation modal — a full-screen contextual help overlay accessible from every section via the ❓ Help button; 12 sections covering every panel and field, navigable via a sidebar
• Section persistence after save — saving settings returns the admin to the same panel section the user was in rather than jumping to the top

2.6.5

• Rock-solid search modal — the open/close click handler now runs unconditionally at page load, independent of any JS configuration flag
• Full deferred-script support — the plugin JS now detects whether the DOM is already parsed when the script executes; if an optimisation plugin adds defer, the init runs immediately

2.6.2

• Visual gradient picker for container background — a fully mouse-driven widget: live preview strip, Linear / Radial type toggle, 8-direction compass rose, 0–360° fine-tune slider, two native colour pickers

2.6.0

• Accordion menu builder — collapsible per-item editor with clearly labelled sections; streamlined Add pane; polished drag-and-drop rows

2.5.0

• Google Font picker — searchable dropdown with 70+ fonts, lazy typeface preview, live update
• Onboarding tutorial — floating 🐝 bee mascot auto-starts on first visit and guides through 4 steps
• Search bar — moved to free tier; Menu tab + In-page search tab with full keyboard navigation

2.4.1

• Accessibility master toggle — all WCAG features disabled by default, activated with a single switch
• Close button color config — color pickers for the × close button in Fullscreen/Drawer modes

2.4.0

• Added complete Accessibility settings panel (WCAG 2.2 AA): keyboard navigation, focus ring, skip link, ARIA, touch targets, reduced motion, high-contrast, focus trap in mobile overlay

2.3.5

• Added 12 demo templates for the Mega Menu editor — load a full column layout in one click

2.3.2

• Mega Menu: gradient background picker with 12 presets and custom gradient builder; font size, link color, heading color and accent/icon color controls; icon picker for all item types; drag & drop reordering

2.3.0

• Introduced Mega Menu — full-width column panels for first-level nav items (free); up to 4 columns, 5 item types, mobile support

2.2.0

• Added 20 preset themes, link border-radius, submenu styling, WP Menu Integration, full Reset button

2.1.1

• Initial release — builder, 4 mobile modes, sticky, scroll progress bar, entrance animations, import/export, multilingual