PHPackages howard/howard\_sidebar\_menu\_block - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. howard/howard\_sidebar\_menu\_block ActiveDrupal-module[Utility & Helpers](/categories/utility) howard/howard\_sidebar\_menu\_block =================================== Provides a sophisticated context-aware sidebar navigation menu for Howard University sites that automatically displays relevant menu items based on the current page position in the site hierarchy. 11.0.5(10mo ago)0205GPL-2.0-or-laterPHP Since Apr 10Pushed 10mo ago2 watchersCompare [ Source](https://github.com/howard-university-web-services/howard_sidebar_menu_block)[ Packagist](https://packagist.org/packages/howard/howard_sidebar_menu_block)[ Docs](https://github.com/howard-university-web-services/howard_sidebar_menu_block)[ RSS](/packages/howard-howard-sidebar-menu-block/feed)WikiDiscussions 8.x-1.x Synced 2d ago READMEChangelog (1)Dependencies (1)Versions (13)Used By (0) Howard Sidebar Menu Block ========================= [](#howard-sidebar-menu-block) [![Drupal 10](https://camo.githubusercontent.com/35dede77fb5a94a10575eb79997c14f976670fba4ed71a4ee4264ad39b5ee50b/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f44727570616c2d31302d626c7565)](https://camo.githubusercontent.com/35dede77fb5a94a10575eb79997c14f976670fba4ed71a4ee4264ad39b5ee50b/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f44727570616c2d31302d626c7565) [![Drupal 11](https://camo.githubusercontent.com/64821dd94dd315b8531591201584ad20eb85cfede76919817cf0f631775a700e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f44727570616c2d31312d626c7565)](https://camo.githubusercontent.com/64821dd94dd315b8531591201584ad20eb85cfede76919817cf0f631775a700e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f44727570616c2d31312d626c7565) [![Version](https://camo.githubusercontent.com/5eb9fa2e098e1669626e94048d052652dfc1031f7fe4feaf0339266b7069a0a9/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f76657273696f6e2d31312e302e342d677265656e)](https://camo.githubusercontent.com/5eb9fa2e098e1669626e94048d052652dfc1031f7fe4feaf0339266b7069a0a9/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f76657273696f6e2d31312e302e342d677265656e) [![License](https://camo.githubusercontent.com/a7cd0356d876c33d51770cadafc90edee39132eee876c9b4a896014c139215ef/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d47504c2d2d322e302b2d626c7565)](https://camo.githubusercontent.com/a7cd0356d876c33d51770cadafc90edee39132eee876c9b4a896014c139215ef/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d47504c2d2d322e302b2d626c7565) A sophisticated sidebar navigation module for Howard University's Drupal sites that provides intelligent, context-aware menu navigation based on the current page's position in the site hierarchy. โœจ Features ---------- [](#-features) - **๐ŸŽฏ Context-Aware Navigation**: Automatically determines current page position and displays relevant submenu items - **โšก Performance Optimized**: Efficient menu tree manipulation with intelligent caching - **๐ŸŽจ Flexible Theming**: Custom Twig templates with complete design control - **โ™ฟ Accessibility Compliant**: WCAG guidelines support with proper ARIA labels - **๐Ÿ“ฑ Responsive Design**: Mobile-friendly navigation with responsive breakpoints - **๐Ÿ”’ Security Focused**: Proper access control and XSS prevention ๐Ÿš€ Quick Start ------------- [](#-quick-start) ### Installation [](#installation) **Composer (Recommended)**: ``` composer require howard/howard_sidebar_menu_block drush en howard_sidebar_menu_block ``` **Manual Installation**: 1. Download from [GitHub releases](https://github.com/howard-university-web-services/howard_sidebar_menu_block/releases) 2. Extract to `modules/contrib/howard_sidebar_menu_block` 3. Enable: `drush en howard_sidebar_menu_block` ### Basic Setup [](#basic-setup) 1. **Enable the module**: Admin โ†’ Extend โ†’ Howard Sidebar Menu Block 2. **Place the block**: Admin โ†’ Structure โ†’ Block layout โ†’ Place "Howard Sidebar Menu Block" 3. **Configure**: Choose your sidebar region and configure visibility settings ๐Ÿ“‹ Requirements -------------- [](#-requirements) - **Drupal**: 10.0+ or 11.0+ - **PHP**: 8.1+ - **Dependencies**: Block (Core), Menu (Core) ๐Ÿ”ง How It Works -------------- [](#-how-it-works) The module intelligently analyzes your current page's position in the main menu hierarchy: 1. **Detects Current Position**: Determines where you are in the menu structure 2. **Finds Parent Context**: Identifies the parent menu item for contextual navigation 3. **Builds Relevant Tree**: Constructs a menu tree showing siblings and children 4. **Renders Contextually**: Displays only relevant navigation options ### Example Behavior [](#example-behavior) ``` Main Menu: On "About โ†’ History" page, sidebar shows: โ”œโ”€โ”€ Home โ”œโ”€โ”€ History โ† (current page) โ”œโ”€โ”€ About โ”œโ”€โ”€ Leadership โ”‚ โ”œโ”€โ”€ History โ”œโ”€โ”€ Mission โ”‚ โ”œโ”€โ”€ Leadership โ””โ”€โ”€ Contact โ”‚ โ””โ”€โ”€ Mission โ”œโ”€โ”€ Programs โ””โ”€โ”€ Contact ``` ๐Ÿ“š Documentation --------------- [](#-documentation) Comprehensive documentation is available in the [`docs/`](docs/) folder: - **[๐Ÿ“– Documentation Index](docs/README.md)** - Overview of all documentation - **[๐Ÿ› ๏ธ Installation Guide](docs/INSTALL.md)** - Detailed setup instructions - **[โš™๏ธ API Documentation](docs/API.md)** - Technical specifications for developers - **[๐Ÿ‘ฉโ€๐Ÿ’ป Developer Guide](docs/DEVELOPER.md)** - Customization and development - **[๐Ÿ“ Changelog](docs/CHANGELOG.md)** - Version history and release notes - **[๐Ÿ“ Coding Standards](docs/CODING_STANDARDS.md)** - Code quality guidelines - **[๐Ÿ“‹ Release Checklist](docs/RELEASE_CHECKLIST.md)** - Release management ๐ŸŽจ Customization --------------- [](#-customization) ### Template Override [](#template-override) Copy templates to your theme for customization: ``` cp modules/contrib/howard_sidebar_menu_block/templates/* themes/your_theme/templates/ ``` ### CSS Styling [](#css-styling) Basic styling example: ``` .sidebar-menu { background: #f8f9fa; border: 1px solid #dee2e6; border-radius: 0.375rem; padding: 1rem; } .sidebar-menu .nav-link { display: block; padding: 0.5rem 0.75rem; color: #495057; text-decoration: none; } .sidebar-menu .nav-link:hover { background-color: #e9ecef; } ``` ๐Ÿงช Testing --------- [](#-testing) ### Run Tests [](#run-tests) ``` # Unit tests vendor/bin/phpunit modules/contrib/howard_sidebar_menu_block/tests/src/Unit/ # Functional tests vendor/bin/phpunit modules/contrib/howard_sidebar_menu_block/tests/src/Functional/ ``` ### Manual Testing [](#manual-testing) 1. Create a multi-level menu structure 2. Place the sidebar block in a region 3. Navigate to different pages and verify contextual display 4. Test with different user permissions 5. Verify cache invalidation works correctly ๐Ÿ” Troubleshooting ----------------- [](#-troubleshooting) ### Common Issues [](#common-issues) **Block not appearing:** - Check block placement and region configuration - Verify theme has the target region - Clear all caches: `drush cr` **Wrong menu items showing:** - Verify main menu structure - Check menu item access permissions - Review active trail detection **Performance issues:** - Enable page caching - Check for large menu structures (>100 items) - Monitor memory usage For detailed troubleshooting, see the [Installation Guide](docs/INSTALL.md#troubleshooting-installation). ๐Ÿค Contributing -------------- [](#-contributing) We welcome contributions! Please see our [Developer Guide](docs/DEVELOPER.md) and [Coding Standards](docs/CODING_STANDARDS.md). ### Development Setup [](#development-setup) ``` git clone https://github.com/howard-university-web-services/howard_sidebar_menu_block.git composer install drush en howard_sidebar_menu_block ``` ### Code Quality [](#code-quality) ``` # Check coding standards vendor/bin/phpcs --standard=Drupal,DrupalPractice src/ # Run tests vendor/bin/phpunit tests/ ``` ๐Ÿ“Š Version Information --------------------- [](#-version-information) - **Current Version**: 11.0.3 - **Drupal Compatibility**: 10.0+ | 11.0+ - **Release Date**: July 7, 2025 - **Next Release**: [View Milestone](https://github.com/howard-university-web-services/howard_sidebar_menu_block/milestones) ๐Ÿ“ž Support --------- [](#-support) - **๐Ÿ› Report Issues**: [GitHub Issues](https://github.com/howard-university-web-services/howard_sidebar_menu_block/issues) - **๐Ÿ’ฌ Discussions**: [GitHub Discussions](https://github.com/howard-university-web-services/howard_sidebar_menu_block/discussions) - **๐Ÿ“š Documentation**: [Project Docs](docs/) - **๐Ÿ‘จโ€๐Ÿ’ป Maintainer**: Dan Rogers ([Drupal.org](https://www.drupal.org/u/dan_rogers)) ๐Ÿ“„ License --------- [](#-license) This project is licensed under the GPL-2.0+ License - see the [LICENSE](LICENSE) file for details. ๐Ÿ›๏ธ About Howard University -------------------------- [](#๏ธ-about-howard-university) This module is developed and maintained by Howard University Web Services for use across Howard University's digital properties. Howard University is a leading research university providing an educational experience of exceptional value to students of high academic standing. --- **๐ŸŒŸ Star this repository if you find it useful!** ### Health Score 39 โ€” LowBetter than 86% of packages Maintenance54 Moderate activity, may be stable Popularity11 Limited adoption so far Community13 Small or concentrated contributor base Maturity67 Established project with proven stability Bus Factor1 Top contributor holds 85.7% of commits โ€” single point of failure How is this calculated?**Maintenance (25%)** โ€” Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** โ€” Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** โ€” Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** โ€” Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~228 days Recently: every ~16 days Total 11 Last Release 309d ago Major Versions 8.1.4 โ†’ 11.0.02025-05-06 ### Community Maintainers ![](https://www.gravatar.com/avatar/b26755984e1a3152bf53dffa104c927637b824f54c2aa817f02a5039cf22c60c?d=identicon)[danrogers](/maintainers/danrogers) ![](https://www.gravatar.com/avatar/afd055eb77f1d251a8a0eb703682f7fa5a7297a8e4c474d666f2d04a063e4046?d=identicon)[anthony.neumann](/maintainers/anthony.neumann) ![](https://www.gravatar.com/avatar/c5011af91052816028d937052528c1c83e414f1014245fb850f450bc003b3a3c?d=identicon)[HowardWebServices](/maintainers/HowardWebServices) ![](https://www.gravatar.com/avatar/ddd8e8d2b49ff3d896a086c456d8cfe199bc0490ab8f22ee7abeb24e67dc6040?d=identicon)[JhamereWilsonHU](/maintainers/JhamereWilsonHU) --- Top Contributors [![drogers98](https://avatars.githubusercontent.com/u/3209424?v=4)](https://github.com/drogers98 "drogers98 (18 commits)")[![Skerins42](https://avatars.githubusercontent.com/u/105609564?v=4)](https://github.com/Skerins42 "Skerins42 (3 commits)") --- Tags drupalmenumodulenavigationsidebarHoward University ### Embed Badge ![Health badge](/badges/howard-howard-sidebar-menu-block/health.svg) ``` [![Health](https://phpackages.com/badges/howard-howard-sidebar-menu-block/health.svg)](https://phpackages.com/packages/howard-howard-sidebar-menu-block) ``` ### Alternatives [spatie/menu Html menu generator 7592.9M6](/packages/spatie-menu)[akaunting/laravel-menu Menu and sidebar management package for Laravel 38233.8k](/packages/akaunting-laravel-menu)[verbb/navigation Create navigation menus for your site. 90683.7k17](/packages/verbb-navigation)[kartik-v/yii2-widget-sidenav An enhanced side navigation menu styled for bootstrap (sub repo split from yii2-widgets) 364.0M8](/packages/kartik-v-yii2-widget-sidenav)[symbiote/silverstripe-grouped-cms-menu Allows you to group CMS menu items. 3696.2k6](/packages/symbiote-silverstripe-grouped-cms-menu)[belugadigital/kirby-navigation Kirby 5 field for hierarchical menus with drag & drop level indentation. 8713.4k](/packages/belugadigital-kirby-navigation) PHPackages ยฉ 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)