Important

You are browsing upcoming documentation for version 5.1 of OroCommerce, OroCRM, and OroPlatform, scheduled for release in March 2023. Read version 5.0 (the latest LTS version) of the Oro documentation to get up-to-date information.

See our Release Process documentation for more information on the currently supported and upcoming releases.

Main Navigation Menu

The main navigation menu that is displayed on the storefront is rendered within main_menu layout block that is present on all pages. The name of the main navigation menu is fetched from the system configuration - oro_commerce_menu.main_navigation_menu that has a default value - commerce_main_menu.

Note

commerce_main_menu is originally declared in the @OroCommerceMenuBundle/Resources/config/oro/navigation.yml.

Main navigation menu makes use of Menu Templates mechanism to render the top-level menu items.

Navigation Root Menu Items

The main navigation menu is automatically populated with menu items by the menu builder Oro\Bundle\CommerceMenuBundle\Builder\NavigationRootBuilder taking data either from Web catalog or Master Catalog. Depending on the system configuration the menu builder delegates the responsibility to inner builders:

1. Oro\Bundle\CommerceMenuBundle\Builder\WebCatalogNavigationRootBuilder that sets the Web Catalog navigation root content node to the root menu item turning it into the Content Node Menu Item.
2. Oro\Bundle\CommerceMenuBundle\Builder\MasterCatalogNavigationRootBuilder that sets the Master Catalog root category to the root menu item turning it into the Category Menu Item.