Skip to main content

Menu Item

Add menu item

Add a new menu item to the Shopware admin menu. The content of the menu item module is determined by your locationId. A specific view or a set of actions can be triggered based on the locationId.

Usage:

ui.menu.addMenuItem({
label: 'Test item',
locationId: 'your-location-id',
displaySearchBar: true,
parent: 'sw-catalogue',
})

Parameters

NameRequiredDefaultDescription
labeltrueThe label of the tab bar item
locationIdtrueThe id for the content of the menu item module
displaySearchBarfalsetrueToggles the sw-page search bar on/off
parentfalse'sw-extension'Determines under which main menu entry your item is displayed
positionfalse110Determines the position of your menu item

Example

Menu item example

import { location, ui } from '@shopware-ag/meteor-admin-sdk';

// General commands
if (location.is(sw.location.MAIN_HIDDEN)) {
// Add the menu item to the catalogue module
ui.menu.addMenuItem({
label: 'Test item',
displaySearchBar: true,
locationId: 'your-location-id',
parent: 'sw-catalogue',
});
}

// Render your custom view
if (location.is('your-location-id')) {
document.body.innerHTML = '<h1 style="text-align: center">Hello from your menu item</h1>';
}