Menu Helper
Le helper Menu fournit des méthodes pour récupérer et manipuler les menus WordPress.
Installation
use Elementum\Helpers\Menu;
Méthodes
getMenuByLocation(string $location): array
Récupère un menu par son emplacement (theme_location).
Paramètres :
$location(string) : Slug de l'emplacement du menu
Retourne : array - Arbre du menu avec les items et sous-items
Exemple :
$mainMenu = Menu::getMenuByLocation('main-menu');
getMenuTreeByLocation(string $location): array
Récupère un menu par son emplacement et retourne une structure arborescente.
Paramètres :
$location(string) : Slug de l'emplacement du menu
Retourne : array - Arbre hiérarchique du menu
Exemple :
$menuTree = Menu::getMenuTreeByLocation('main-menu'); foreach ($menuTree as $item) { echo $item->title; if ($item->children) { foreach ($item->children as $child) { echo $child->title; } } }
Structure retournée
Chaque item de menu contient :
[ 'ID' => 123, 'title' => 'Accueil', 'url' => 'https://example.com', 'menu_item_parent' => 0, 'classes' => ['menu-item', 'current-menu-item'], 'target' => '_blank', 'children' => [...] // Sous-items ]
Cas d'usage
Dans un controller
use Elementum\Helpers\Menu; use Elementum\Attributes\Template; class LayoutController { #[Template('base.html.twig')] public function base(): array { return [ 'mainMenu' => Menu::getMenuByLocation('main-menu'), 'footerMenu' => Menu::getMenuByLocation('footer-menu') ]; } }
Dans un template Twig
<nav class="main-navigation"> <ul> {% for item in mainMenu %} <li class="{{ item.classes|join(' ') }}"> <a href="{{ item.url }}">{{ item.title }}</a> {% if item.children %} <ul class="submenu"> {% for child in item.children %} <li> <a href="{{ child.url }}">{{ child.title }}</a> </li> {% endfor %} </ul> {% endif %} </li> {% endfor %} </ul> </nav>