Administration Menu

The admin side menu is implemented by KnpMenuBundle, and to extend it, you can use events. An example of such an extension is described in the cookbook Adding a New Administration Page.

To see how the side menu works programmatically, you can see the SideMenuBuilder class where it is created. The side menu builder is tagged with knp_menu.menu_builder and is accessible under the alias admin_side_menu.

There are a few customizations on top of the standard KnpMenu:

Template

The template is not configured globally (via config/packages/twig.yaml) but instead, the template is provided during the rendering in a Twig template:

{{ knp_menu_render('admin_side_menu', {template: 'ShopsysFrameworkBundle:Admin/Menu:side_menu.html.twig'}) }}`.

The menu template works similarly to the default knp_menu.html.twig, but it uses BEM classes and supports a few custom features.

Javascript

The behavior of the side menu is controlled via the JS component Shopsys.sideMenu.

Icons

There is an extra attribute icon supported to allow icons in the menu. Currently, it's used only for the first level of menu items, but it will also work when set to nested items.

It can be assigned to a menu item in an event subscriber by calling, e.g.

$menuItem->setExtra('icon', 'cart');

A list of all supported icons can be found in docs/generated/webfont-admin-svg.html in your project (input the name without the svg- prefix).

Superadmin access

There is an extra boolean attribute superadmin supported to allow highlighting of restricted access of the menu.

It's only used for the visual effect. The restriction itself has to be done manually using the method

AuthorizationCheckerInterface::isGranted(Roles::ROLE_SUPER_ADMIN);

Events

After building the whole menu a ConfigureMenuEvent::SIDE_MENU_ROOT event is dispatched. After adding each of the submenus, a different event is dispatched. You can take a look at the class ConfigureMenuEvent to see all the events and their internals.

These can be used to extend the menu, either from the project repository or modules.

Routing extension

To render the admin breadcrumb navigation, the menu items are used as well. For this reason, even pages that are not displayed in the menu are added to it (with a display attribute set to false).

These items can have a configured route without some mandatory parameters filled in (e.g., a product edit page without a product ID parameter). To avoid throwing the MissingMandatoryParametersException, we have replaced the original RoutingExtension with our own implementation. It simply doesn't generate a URI when the exception is thrown. The route is still used to resolve the current menu item.

A BreadcrumbOverrider::overrideLastItem(string $label) call can be used in a controller to override the last breadcrumb item. This can be used, for example, to specify which product you're editing in the breadcrumb navigation.