Aller au contenu principal
Version: Next

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>

Voir aussi​