{"id":239297,"date":"2025-07-09T21:33:25","date_gmt":"2025-07-09T21:33:25","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/groundworx-navigation\/"},"modified":"2026-04-01T21:57:26","modified_gmt":"2026-04-01T21:57:26","slug":"groundworx-navigation","status":"publish","type":"plugin","link":"https:\/\/pcd.wordpress.org\/plugins\/groundworx-navigation\/","author":8122980,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"1.1.0","stable_tag":"1.1.0","tested":"6.9.4","requires":"6.5","requires_php":"7.4","requires_plugins":null,"header_name":"Groundworx Navigation","header_author":"Groundworx","header_description":"Responsive Gutenberg navigation for theme.json ready themes. Modal, dropdown, slide-in & hamburger. Supporting: accordion, stacked, list, vertical, and horizontal.","assets_banners_color":"fafafa","last_updated":"2026-04-01 21:57:26","external_support_url":"","external_repository_url":"","donate_link":"https:\/\/ko-fi.com\/groundworx","header_plugin_uri":"https:\/\/wordpress.org\/plugins\/groundworx-navigation","header_author_uri":"https:\/\/groundworx.dev","rating":0,"author_block_rating":0,"active_installs":20,"downloads":905,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.1":{"tag":"1.0.1","author":"Alexandrie","date":"2025-07-30 21:27:34"},"1.0.2":{"tag":"1.0.2","author":"Alexandrie","date":"2025-08-19 02:03:46"},"1.0.3":{"tag":"1.0.3","author":"Alexandrie","date":"2025-09-22 04:31:26"},"1.0.4":{"tag":"1.0.4","author":"Alexandrie","date":"2025-09-23 21:49:56"},"1.0.5":{"tag":"1.0.5","author":"Alexandrie","date":"2025-11-07 06:07:30"},"1.0.6":{"tag":"1.0.6","author":"Alexandrie","date":"2025-11-15 20:00:31"},"1.1.0":{"tag":"1.1.0","author":"Alexandrie","date":"2026-04-01 21:57:26"}},"upgrade_notice":{"1.0.6":"

Critical fix for slide-in template layout issues and improved scrollbar behavior. Update recommended for all users.<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.jpg":{"filename":"icon-128x128.jpg","revision":3325268,"resolution":"128x128","location":"assets","locale":""},"icon-256x256.jpg":{"filename":"icon-256x256.jpg","revision":3325268,"resolution":"256x256","location":"assets","locale":""}},"assets_banners":{"banner-1544x500.jpg":{"filename":"banner-1544x500.jpg","revision":3325268,"resolution":"1544x500","location":"assets","locale":""},"banner-772x250.jpg":{"filename":"banner-772x250.jpg","revision":3325268,"resolution":"772x250","location":"assets","locale":""}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.1","1.0.2","1.0.3","1.0.4","1.0.5","1.0.6","1.1.0"],"block_files":[],"assets_screenshots":{"screenshot-1.jpg":{"filename":"screenshot-1.jpg","revision":3325268,"resolution":"1","location":"assets","locale":""},"screenshot-2.jpg":{"filename":"screenshot-2.jpg","revision":3325268,"resolution":"2","location":"assets","locale":""},"screenshot-3.jpg":{"filename":"screenshot-3.jpg","revision":3325268,"resolution":"3","location":"assets","locale":""},"screenshot-4.jpg":{"filename":"screenshot-4.jpg","revision":3325268,"resolution":"4","location":"assets","locale":""},"screenshot-5.jpg":{"filename":"screenshot-5.jpg","revision":3325268,"resolution":"5","location":"assets","locale":""},"screenshot-6.jpg":{"filename":"screenshot-6.jpg","revision":3325268,"resolution":"6","location":"assets","locale":""}},"screenshots":{"1":"Block Editor \u2013 Navigation layout templates in Inspector settings","2":"Slide-In navigation drawer on mobile","3":"Modal navigation full-screen overlay","4":"Classic navigation bar with hamburger menu","5":"Dropdown navigation with submenus","6":"Sticky header navigation in action"},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[204746,148076,1865,1753,6275],"plugin_category":[43],"plugin_contributors":[242341],"plugin_business_model":[],"class_list":["post-239297","plugin","type-plugin","status-publish","hentry","plugin_tags-fse","plugin_tags-gutenberg","plugin_tags-menu","plugin_tags-navigation","plugin_tags-responsive-menu","plugin_category-customization","plugin_contributors-alexandrie","plugin_committers-alexandrie"],"banners":{"banner":"https:\/\/ps.w.org\/groundworx-navigation\/assets\/banner-772x250.jpg?rev=3325268","banner_2x":"https:\/\/ps.w.org\/groundworx-navigation\/assets\/banner-1544x500.jpg?rev=3325268","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/groundworx-navigation\/assets\/icon-128x128.jpg?rev=3325268","icon_2x":"https:\/\/ps.w.org\/groundworx-navigation\/assets\/icon-256x256.jpg?rev=3325268","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/groundworx-navigation\/assets\/screenshot-1.jpg?rev=3325268","caption":"Block Editor \u2013 Navigation layout templates in Inspector settings"},{"src":"https:\/\/ps.w.org\/groundworx-navigation\/assets\/screenshot-2.jpg?rev=3325268","caption":"Slide-In navigation drawer on mobile"},{"src":"https:\/\/ps.w.org\/groundworx-navigation\/assets\/screenshot-3.jpg?rev=3325268","caption":"Modal navigation full-screen overlay"},{"src":"https:\/\/ps.w.org\/groundworx-navigation\/assets\/screenshot-4.jpg?rev=3325268","caption":"Classic navigation bar with hamburger menu"},{"src":"https:\/\/ps.w.org\/groundworx-navigation\/assets\/screenshot-5.jpg?rev=3325268","caption":"Dropdown navigation with submenus"},{"src":"https:\/\/ps.w.org\/groundworx-navigation\/assets\/screenshot-6.jpg?rev=3325268","caption":"Sticky header navigation in action"}],"raw_content":"\n

Groundworx Navigation<\/strong> is a powerful responsive navigation block<\/strong> for WordPress block themes. Build professional navigation menus, mobile-responsive hamburger menus, modal overlays, dropdown navigation, and sticky headers\u2014all with native Gutenberg blocks. No coding required.<\/p>\n\n

Perfect for theme.json block themes<\/strong>, this navigation block gives you complete control over your site's header navigation, mobile menu behavior, and responsive breakpoints.<\/p>\n\n

Why Choose Groundworx Navigation?<\/h4>\n\n

Replace complex navigation plugins with a native Gutenberg block solution. Whether you need a simple navigation bar, mobile hamburger menu, full-screen modal overlay, or off-canvas slide-in drawer\u2014Groundworx Navigation handles it all.<\/p>\n\n

Perfect for:<\/strong>\n* Block theme developers building custom navigation headers\n* Sites requiring mobile-first responsive navigation menus\n* Accessibility-focused WordPress navigation\n* Portfolio and business sites with sticky navigation headers\n* Multi-level navigation structures and deep site menus<\/p>\n\n

Key Features<\/h4>\n\n

Native Gutenberg Navigation Block<\/strong>\nBuild your navigation menu entirely in the WordPress Block Editor\u2014no shortcodes, no legacy menu screens, just blocks.<\/p>\n\n

Four Responsive Layout Templates<\/strong>\n - Modal Navigation<\/strong> - Full-screen overlay menu for mobile devices\n - Modal Dropdown<\/strong> - Dropdown header navigation on desktop, modal on mobile\n - Slide-In Navigation<\/strong> - Off-canvas drawer navigation from right edge\n - Classic Navigation<\/strong> - Traditional navigation bar with hamburger menu collapse<\/p>\n\n

Multiple Menu Display Styles<\/strong>\nAccordion menus \u00b7 Accordion Alt \u00b7 List navigation \u00b7 Vertical menus \u00b7 Horizontal navigation bars \u2014 mix and match with any layout template.<\/p>\n\n

Smart Responsive Behavior<\/strong>\nSet responsive breakpoints (tablet<\/code>, laptop<\/code>, desktop<\/code>, large-desktop<\/code>) and watch your navigation automatically collapse to a hamburger menu or modal overlay at your chosen screen size.<\/p>\n\n

Flexible Position Controls<\/strong>\nRelative, Sticky Header, Fixed Navigation, or Scroll-Up Reveal\u2014create sticky navigation headers without writing custom CSS.<\/p>\n\n

Accessibility-First Navigation<\/strong>\nBuilt-in focus traps, ESC key close, arrow-key navigation, and proper ARIA attributes make your menu accessible by default.<\/p>\n\n

Branding Integration<\/strong>\nAdd Site Logo<\/strong>, Site Title<\/strong>, or Site Tagline<\/strong> blocks anywhere in your navigation header for seamless branding.<\/p>\n\n

Lightweight & Fast<\/strong>\nNo jQuery bloat. Powered by WordPress's native Interactivity API with vanilla JavaScript\u2014no external libraries needed for responsive navigation.<\/p>\n\n

Submenu Controls<\/strong>\n* Control nesting depth (1-5 levels) for complex navigation structures\n* Indent or flatten submenu display\n* Hover or click to open dropdown submenus\n* Icon controls for submenu indicators<\/p>\n\n

Navigation Templates In Detail<\/h4>\n\n

Modal Navigation<\/strong>\nPerfect for mobile-first sites. Creates a full-screen overlay navigation menu that slides in from the top or side. Ideal for clean, distraction-free mobile navigation.<\/p>\n\n

Modal Dropdown Navigation<\/strong>\nBest of both worlds: traditional dropdown navigation on desktop, modal overlay on mobile devices. Great for sites with many navigation items.<\/p>\n\n

Slide-In Navigation<\/strong>\nOff-canvas navigation drawer that slides in from the right edge. Popular for modern web apps and mobile-optimized sites.<\/p>\n\n

Classic Navigation<\/strong>\nTraditional horizontal navigation bar that collapses to a hamburger menu icon on smaller screens. The most familiar navigation pattern for users.<\/p>\n\n

Block Theme Ready<\/h4>\n\n

Groundworx Navigation is built specifically for theme.json block themes<\/strong>. Works perfectly with:\n* Twenty Twenty-Four\n* Twenty Twenty-Five
\n* Blockbase\n* Frost\n* Any FSE (Full Site Editing) block theme<\/p>\n\n

Note:<\/strong> Requires a theme.json-ready block theme. Not compatible with classic PHP themes.<\/p>\n\n\n

Automatic Installation<\/h4>\n\n
    \n
  1. Go to Plugins \u2192 Add New<\/strong> in your WordPress admin<\/li>\n
  2. Search for \"Groundworx Navigation<\/strong>\"<\/li>\n
  3. Click Install Now<\/strong> then Activate<\/strong><\/li>\n
  4. Add the Groundworx Navigation<\/strong> block in the Block Editor<\/li>\n<\/ol>\n\n

    Manual Installation<\/h4>\n\n
      \n
    1. Download the plugin zip file<\/li>\n
    2. Upload to \/wp-content\/plugins\/<\/code> or install via Plugins \u2192 Add New \u2192 Upload Plugin<\/strong><\/li>\n
    3. Activate Groundworx Navigation<\/strong><\/li>\n
    4. Start building responsive navigation menus in the Block Editor<\/li>\n<\/ol>\n\n

      Quick Start Guide<\/h4>\n\n
        \n
      1. In the Block Editor, add the Groundworx Navigation<\/strong> block<\/li>\n
      2. Choose a navigation layout template (Modal, Slide-In, Dropdown, or Classic)<\/li>\n
      3. In Menu Settings<\/strong>, click Create New Menu<\/strong> or select existing navigation menu<\/li>\n
      4. Insert Navigation Menu<\/strong>, Branding<\/strong>, or Spacer<\/strong> blocks<\/li>\n
      5. Configure responsive breakpoint, sticky header, accordion\/list display in Layout Settings<\/strong><\/li>\n
      6. Publish and view your responsive navigation menu\u2014no coding required<\/li>\n<\/ol>\n\n\n
        \n

        Does this replace WordPress core Navigation block?<\/h3><\/dt>\n

        Groundworx Navigation is an alternative focused on complex responsive layouts\u2014modal overlays, slide-in navigation, sticky headers, hamburger menus\u2014without requiring custom CSS. Both navigation blocks can coexist in WordPress.<\/p><\/dd>\n

        Why can't I select Fixed or Scroll-Up Reveal position?<\/h3><\/dt>\n

        Fixed and Scroll-Up Reveal navigation positions only appear when the block is placed inside a Header<\/code> template part. In regular page content, only Relative<\/strong> and Sticky<\/strong> positions are available for navigation menus.<\/p><\/dd>\n

        What responsive breakpoints are available?<\/h3><\/dt>\n

        Choose from tablet<\/code>, laptop<\/code>, desktop<\/code>, or large-desktop<\/code> breakpoints\u2014matching Groundworx breakpoint utilities. Set Toggle Behaviour \u2192 Responsive<\/strong> in navigation settings and pick your breakpoint.<\/p><\/dd>\n

        Which menu display styles are included?<\/h3><\/dt>\n

        Accordion, Accordion Alt, List, Vertical, and Horizontal navigation displays. Each menu style works with any layout template (Modal, Modal Dropdown, Slide-In, or Classic navigation).<\/p><\/dd>\n

        Will this work with my WordPress theme?<\/h3><\/dt>\n

        Groundworx Navigation requires a theme.json block theme<\/strong> (also called FSE or Full Site Editing theme). If you're using a classic PHP theme or older block theme without full theme.json support, the navigation block won't function correctly.<\/p>\n\n

        Solution:<\/strong> Use a modern block theme like Twenty Twenty-Four, Twenty Twenty-Five, Blockbase, or Frost\u2014all fully compatible with Groundworx Navigation.<\/p><\/dd>\n

        Can I create mega menus with multiple columns?<\/h3><\/dt>\n

        Yes! Use the flexible block structure to create multi-column navigation menus and mega menu layouts within any navigation template.<\/p><\/dd>\n

        Does it work with WooCommerce?<\/h3><\/dt>\n

        Absolutely. Groundworx Navigation works with any WordPress block theme, including WooCommerce-enabled sites. Build custom navigation menus with your product categories.<\/p><\/dd>\n

        Is the navigation mobile-responsive?<\/h3><\/dt>\n

        Yes! That's the core feature. Choose responsive behavior and breakpoints, and your navigation automatically adapts\u2014collapsing to a hamburger menu, modal, or slide-in drawer on mobile devices.<\/p><\/dd>\n

        Can I have sticky navigation headers?<\/h3><\/dt>\n

        Yes. Select Sticky<\/strong> or Fixed<\/strong> position in navigation settings to create sticky header navigation that stays visible while scrolling.<\/p><\/dd>\n\n<\/dl>\n\n\n

        1.1.0<\/h4>\n\n
          \n
        • Consolidated all block assets into central editor\/style handles (removed per-block file references)<\/li>\n
        • Refactored all block registrations to use central entry point pattern<\/li>\n
        • Added PHP namespaces to block renderers and utility files<\/li>\n
        • Fix: Submenu color controls now display correctly for classic layout<\/li>\n
        • Improved internationalization for editor panel titles, toolbar buttons, and breakpoint labels<\/li>\n
        • Hardened output escaping for inline CSS values in block render callbacks<\/li>\n
        • Fix: aria-label<\/code> now applied to <nav><\/code> element with \"Main Navigation\" default fallback<\/li>\n
        • Fix: aria-controls<\/code> on toggle buttons now points to the menu content panel<\/li>\n
        • Fix: Close button no longer has permanent tabindex=\"-1\"<\/code><\/li>\n
        • Fix: Open button now includes aria-expanded<\/code> state<\/li>\n
        • Lowered PHP requirement to 7.4<\/li>\n
        • Updated Tested up to 6.9<\/li>\n<\/ul>\n\n

          1.0.6<\/h4>\n\n
            \n
          • Fix: Resolved slide-in template layout propagation issue that caused menu to display incorrect layout type (horizontal-menu instead of accordion)<\/li>\n
          • Fix: Improved scrollbar color and behavior for long navigation menus that exceed screen height<\/li>\n
          • Fix: Corrected React hook dependency array to prevent crash when switching toggle behavior modes<\/li>\n<\/ul>\n\n

            1.0.5<\/h4>\n\n
              \n
            • New: Added Max Visible Nesting Level control (1-5 levels) to limit submenu depth for visitors<\/li>\n
            • New: Added Indent Submenu and Flatten Submenu options for enhanced menu structure control <\/li>\n
            • Improvement: Refactored responsive layout logic into reusable hook, reducing code duplication<\/li>\n
            • Fix: Resolved React hook dependency issues that caused crashes when switching toggle behavior<\/li>\n
            • Fix: Fixed memory leak in navigation bounds measurement (resize listener cleanup)<\/li>\n
            • Fix: Corrected infinite loop in navigation-menu attribute updates<\/li>\n
            • Enhancement: Renamed \"Stacked Menu\" to \"Accordion Alt\" for better clarity<\/li>\n<\/ul>\n\n

              1.0.4<\/h4>\n\n
                \n
              • Fix: geometry mismatch when OS is set to \"Always show scroll bars\" could mis-detect nav bounds.<\/li>\n
              • Improve: no layout shift when locking body; close button no longer jumps.<\/li>\n
              • Improve: optional menu scrollbar styling.<\/li>\n<\/ul>\n\n

                1.0.3<\/h4>\n\n
                  \n
                • Fixed editor icon display issue (now hidden when SVG is used)<\/li>\n
                • General stability and performance improvements for navigation menu<\/li>\n<\/ul>\n\n

                  1.0.2<\/h4>\n\n
                    \n
                  • Improved navigation UX<\/li>\n
                  • Fixed issue where navigation menu would sometimes not open<\/li>\n
                  • Fixed navigation editing behavior bug<\/li>\n<\/ul>\n\n

                    1.0.1<\/h4>\n\n
                      \n
                    • Fix: Adjusted editor canvas width detection for iframe-less block editor in WordPress 6.8+<\/li>\n<\/ul>\n\n

                      1.0.0<\/h4>\n\n
                        \n
                      • Initial public release \u2013 Modal, Modal Dropdown, Slide-In, and Classic navigation layouts with accordion\/accordion-alt\/list\/vertical\/horizontal menu displays.<\/li>\n<\/ul>","raw_excerpt":"Responsive navigation menu block for WordPress block themes. Build mobile menus, hamburger navigation, modal overlays, dropdown menus & sticky hea …","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/239297","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=239297"}],"author":[{"embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/alexandrie"}],"wp:attachment":[{"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=239297"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=239297"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=239297"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=239297"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=239297"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=239297"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}