• Documentation >
• Guide >
• Content rendering >
• Layout >
• Add navigation menu

Add navigation menu

To add a navigation menu to your website, prepare a general layout template in a templates/themes/<theme_name>/pagelayout.html.twig file.

This template can contain things such as header, menu, footer, as well as assets for the whole site, and all other templates extend it.

To select items that should be rendered in the menu, you can use one of the following ways:

• create a query
• create a MenuBuilder

Render menu using a query

To create a menu that contains a specific set of Content items, for example all content under the root Location, use a Query Type.

First, in src/QueryType, create a custom MenuQueryType.php file that queries for all items that you want in the menu:

<?php declare(strict_types=1);

namespace App\QueryType;

use eZ\Publish\API\Repository\Values\Content\LocationQuery;
use eZ\Publish\API\Repository\Values\Content\Query;
use eZ\Publish\API\Repository\Values\Content\Query\SortClause;
use eZ\Publish\Core\QueryType\QueryType;

class MenuQueryType implements QueryType
{
    public function getQuery(array $parameters = [])
    {
        $criteria = new Query\Criterion\LogicalAnd([
            new Query\Criterion\Visibility(Query\Criterion\Visibility::VISIBLE),
            new Query\Criterion\ParentLocationId(2),
        ]);
        $options = [
            'filter' => $criteria,
            'sortClauses' => [
                new SortClause\Location\Priority(LocationQuery::SORT_ASC),
            ],
        ];

        return new LocationQuery($options);
    }

    public static function getName()
    {
        return 'Menu';
    }

    public function getSupportedParameters()
    {
        return [];
    }
}

In this case, it queries for all visible children of Location 2, the root Location, (lines 15-16) and renders them in order according to their Location priority.

The Query Type has the name Menu (line 28). You can use it in the template to render the menu. Add the following ez_render_content_query function to the pagelayout_html.twig template:

{{ ez_render_content_query({
    'query': {
        'query_type': 'Menu',
        'assign_results_to': 'menuItems'
    },
    'template': '@ezdesign/pagelayout_menu.html.twig',
}) }}

Next, add the templates/themes/<theme_name>/pagelayout_menu.html.twig template, which renders the individual items of the menu:

{% if menuItems is defined and menuItems is not empty %}
    {% for item in menuItems %}
        <li><a href="{{ ez_path(item.valueObject) }}">{{ ez_content_name(item.valueObject.contentInfo) }}</a></li>
    {% endfor %}
{% endif %}

Create a MenuBuilder

To make a more configurable menu, where you select the specific items to render, use the KNPMenuBundle that is installed together with the product.

To use it, first create a MenuBuilder.php file in src/Menu:

<?php declare(strict_types=1);

namespace App\Menu;

use Knp\Menu\FactoryInterface;

class MenuBuilder
{
    private $factory;

    public function __construct(FactoryInterface $factory)
    {
        $this->factory = $factory;
    }

    public function buildMenu()
    {
        $menu = $this->factory->createItem('root');

        $menu->addChild('Home', ['route' => 'ez_urlalias', 'routeParameters' => [
            'locationId' => 2,
        ]]);
        $menu->addChild('Blog', ['route' => 'ez_urlalias', 'routeParameters' => [
            'locationId' => 67,
        ]]);
        $menu->addChild('Search', ['route' => 'ezplatform.search']);

        return $menu;
    }
}

In the builder, you can define items that you want in the menu. For example, lines 20-22 add a specific Location by using the ez_urlalias route. Line 26 adds a defined system route that leads to the search form.

Next, register the menu builder as a service:

App\Menu\MenuBuilder:
    tags:
        - {name: knp_menu.menu_builder, method: buildMenu, alias: root}

Finally, you can render the menu in pagelayout.html.twig. Identify it by the name that you provided in the Menu Builder's buildMenu() method:

{{ knp_menu_render('root') }}