$npx -y skills add edutrul/drupal-ai --skill drupal-menusDrupal menus — links.menu.yml, links.task.yml, links.action.yml, contextual links, and programmatic menu manipulation.
| 1 | # Drupal Menus |
| 2 | |
| 3 | ## Menu Links (*.links.menu.yml) |
| 4 | |
| 5 | ```yaml |
| 6 | # my_module.links.menu.yml |
| 7 | |
| 8 | my_module.admin: |
| 9 | title: 'My Module' |
| 10 | description: 'Configure My Module.' |
| 11 | route_name: my_module.admin |
| 12 | parent: system.admin_config |
| 13 | weight: 10 |
| 14 | |
| 15 | my_module.admin.settings: |
| 16 | title: 'Settings' |
| 17 | route_name: my_module.admin.settings |
| 18 | parent: my_module.admin |
| 19 | weight: 0 |
| 20 | ``` |
| 21 | |
| 22 | ## Task Links / Tabs (*.links.task.yml) |
| 23 | |
| 24 | ```yaml |
| 25 | # my_module.links.task.yml |
| 26 | |
| 27 | my_module.settings_tab: |
| 28 | title: 'Settings' |
| 29 | route_name: my_module.admin.settings |
| 30 | base_route: my_module.admin |
| 31 | |
| 32 | my_module.advanced_tab: |
| 33 | title: 'Advanced' |
| 34 | route_name: my_module.admin.advanced |
| 35 | base_route: my_module.admin |
| 36 | weight: 10 |
| 37 | ``` |
| 38 | |
| 39 | ## Action Links (*.links.action.yml) |
| 40 | |
| 41 | ```yaml |
| 42 | # my_module.links.action.yml |
| 43 | |
| 44 | my_module.add_item: |
| 45 | title: 'Add Item' |
| 46 | route_name: my_module.add |
| 47 | appears_on: |
| 48 | - my_module.list |
| 49 | ``` |
| 50 | |
| 51 | ## Programmatic Menu Tree |
| 52 | |
| 53 | ```php |
| 54 | use Drupal\Core\Menu\MenuTreeParameters; |
| 55 | |
| 56 | $menu_tree = \Drupal::menuTree(); |
| 57 | $parameters = new MenuTreeParameters(); |
| 58 | $parameters->setMaxDepth(2)->onlyEnabledLinks(); |
| 59 | |
| 60 | $tree = $menu_tree->load('main', $parameters); |
| 61 | $manipulators = [ |
| 62 | ['callable' => 'menu.default_tree_manipulators:checkAccess'], |
| 63 | ['callable' => 'menu.default_tree_manipulators:generateIndexAndSort'], |
| 64 | ]; |
| 65 | $tree = $menu_tree->transform($tree, $manipulators); |
| 66 | $build = $menu_tree->build($tree); |
| 67 | ``` |
| 68 | |
| 69 | ## Altering Menu Links |
| 70 | |
| 71 | ```php |
| 72 | #[Hook('menu_links_discovered_alter')] |
| 73 | public function menuLinksDiscoveredAlter(array &$links): void { |
| 74 | if (isset($links['my_module.some_link'])) { |
| 75 | $links['my_module.some_link']['title'] = new TranslatableMarkup('New Title'); |
| 76 | } |
| 77 | } |
| 78 | ``` |
| 79 | |
| 80 | ## Dynamic Menu Links (MenuLinkDefault plugin) |
| 81 | |
| 82 | ```php |
| 83 | // src/Plugin/Menu/MyDynamicMenuLink.php |
| 84 | use Drupal\Core\Menu\MenuLinkDefault; |
| 85 | |
| 86 | final class MyDynamicMenuLink extends MenuLinkDefault { |
| 87 | public function getTitle(): string { |
| 88 | return 'Dynamic Title from ' . $this->getRouteName(); |
| 89 | } |
| 90 | } |
| 91 | ``` |