{"id":20961768,"url":"https://github.com/heimrichhannot/contao-menu-bundle","last_synced_at":"2025-10-28T07:21:06.877Z","repository":{"id":56983895,"uuid":"215747359","full_name":"heimrichhannot/contao-menu-bundle","owner":"heimrichhannot","description":null,"archived":false,"fork":false,"pushed_at":"2024-01-30T14:41:52.000Z","size":57,"stargazers_count":0,"open_issues_count":2,"forks_count":4,"subscribers_count":6,"default_branch":"master","last_synced_at":"2025-04-22T17:21:31.653Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/heimrichhannot.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-10-17T08:56:49.000Z","updated_at":"2021-12-08T10:10:21.000Z","dependencies_parsed_at":"2022-08-21T12:20:47.629Z","dependency_job_id":null,"html_url":"https://github.com/heimrichhannot/contao-menu-bundle","commit_stats":null,"previous_names":[],"tags_count":16,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/heimrichhannot%2Fcontao-menu-bundle","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/heimrichhannot%2Fcontao-menu-bundle/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/heimrichhannot%2Fcontao-menu-bundle/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/heimrichhannot%2Fcontao-menu-bundle/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/heimrichhannot","download_url":"https://codeload.github.com/heimrichhannot/contao-menu-bundle/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254094840,"owners_count":22013648,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-19T02:16:48.415Z","updated_at":"2025-10-28T07:21:06.872Z","avatar_url":"https://github.com/heimrichhannot.png","language":"PHP","readme":"# Contao Menu Bundle\n\nThis bundle adds a multi-level menu module for the Contao CMS.\n\n## Features\n\n- submenus are opened by hovering (or by tapping on touch devices)\n- works both for mouse and for touch-based devices\n- includes a preset template for bootstrap 4 (`nav_huh_menu_bs4`) and 5 (`nav_huh_menu_bs5`)\n- define how many levels are collapsed\n- define delays for opening and closing submenus\n\n## Behavior\n\nThe menu is based on the `mouseover` event (\"hover\"). This way it works for both mouse *and* touch-based devices since `mouseover` events are triggered by tap events\non most touch devices.\n\nOn devices with `window.navigator.maxTouchPoints` being 0, you can also click the submenu headers because submenus are opened by hovering.\n\n## Usage\n\n1. Install the bundle via composer: `composer require heimrichhannot/contao-menu-bundle`\n2. Update the database\n3. Create a new module of type Menu (H\u0026H)\n4. Set the template nav_huh_menu_default to the module\n5. Assign it to your layout (preferably in the header)\n\n## Technical notes\n\n### Events\n\nEvent             | Description\n------------------|------------\n`huhMenu:opening` | Thrown after the menu started opening\n`huhMenu:opened`  | Thrown after the menu has been opened\n`huhMenu:closing` | Thrown after the menu started closing\n`huhMenu:closed`  | Thrown after the menu has been closed\n\n### Why can't submenu headers be clicked on multi-touch devices?\n\nBecause then submenu entries could never be reached.\n\n### On Microsoft Surface\n\nEven in tablet mode the device doesn't throw `touch` but `mouse` events. Also it masquerades as a desktop computer with mouse. Hence it tells the browser\nthat it supports `hovering` (`Modernizr.hovermq` is `true`). So if we'd allow that submenu headers can be tapped and directly opened, this would not only happen\nif a mouse is attached but also in tablet mode while the user uses his finger. In this case submenu entries could never be reached.\n\n### The menu closes when I hover above a submenu\n\nHTML document have to be in `standards` mode. Make sure \u003c!DOCTYPE html\u003e is set!\n\nThis is in most cases caused by CSS margins. Please only use paddings to adjust dimensions of the menus items. Please make sure that submenus (ul and li) take the space\nwhere the cursor can be over.\n\n## Known issues\n\n### What about smaller screen dimensions?\n\nCurrently this menu is only for dimensions like tablet landscape and larger. So please use another module for this case. Nevertheless it's planned for this bundle\nto support bootstrap's mobile menu for smaller screen dimensions out of the box.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fheimrichhannot%2Fcontao-menu-bundle","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fheimrichhannot%2Fcontao-menu-bundle","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fheimrichhannot%2Fcontao-menu-bundle/lists"}