Configure the Admin Menu

Adding an item

<?php

namespace App\EventSubscriber;

use EasyCorp\Bundle\EasyAdminBundle\Config\MenuItem;
use Pushword\Admin\Menu\AdminMenuItemsEvent;
use Symfony\Component\EventDispatcher\EventSubscriberInterface;

final readonly class AdminMenuSubscriber implements EventSubscriberInterface
{
    public static function getSubscribedEvents(): array
    {
        return [AdminMenuItemsEvent::NAME => 'onMenuItems'];
    }

    public function onMenuItems(AdminMenuItemsEvent $event): void
    {
        $event->addMenuItem(
            MenuItem::linkToRoute('My Custom Page', 'fa fa-star', 'my_custom_route'),
            450,
        );
    }
}

Any EasyAdmin MenuItem works: linkTo(MyCrudController::class, 'Label', 'fa fa-icon'), linkToRoute(), linkToUrl(), subMenu('Label', 'fa fa-icon')->setSubItems([...]), section('Title').

For a single route item, extend Pushword\Admin\Menu\AbstractRouteMenuItemSubscriber (the template editor does):

final readonly class AdminMenuItemSubscriber extends AbstractRouteMenuItemSubscriber
{
    public function __construct()
    {
        parent::__construct('Template Editor', 'fa fa-code', 'admin_template_editor_list', 200);
    }
}

AbstractRouteMenuWithHostsSubscriber takes the SiteRegistry first and turns the item into a per-host submenu when several sites are configured (used by the page scanner).

Default weights

Replacing the menu

getItems() returns array<int, array{weight: int, item: MenuItemInterface}>; setItems() replaces it:

public function onMenuItems(AdminMenuItemsEvent $event): void
{
    $items = array_filter($event->getItems(), static fn (array $item): bool => $item['weight'] >= 500);
    $items[] = ['weight' => 100, 'item' => MenuItem::linkToRoute('Custom', 'fa fa-cog', 'custom_route')];

    $event->setItems($items);
}