3.2 Custom menu

Latest revision as of 15:59, 5 November 2025

Overview

For further navigation support, a custom menu is integrated as a mega menu and can be customized by administrators.

Creating a custom menu with the menu editor

If the custom menu icon is not yet displayed, first create the MediaWiki:CustomMenu/Header page.

From BlueSpice v5.1.2+: The display of the custom menu button can be controlled via the configuration management (Global Actions > Configuration > Skinning. There, activate or deactivate the checkbox for BlueSpiceCustomMenu).

If the menu already exists: Click Edit Menu to switch to edit mode.

If the menu page does not exist, a message will be displayed:

In this case, you can easily create the menu by editing the page. Alternatively, you can also use the "Edit menu" link in the mega menu.

Menu editor

View instructions on the menu editor help page.

Delete the custom menu

To remove the custom menu link-icon from the wiki, the MediaWiki:CustomMenu/Header page must be deleted. The page can be restored via the deletion log.

Layout for many columns

If you're building a menu with many columns, the following CSS adjustment may be helpful. On the Flexiskin special page, enter the following CSS declarations in the "Free CSS" text area:

.navbar-nav .dropdown-menu {text-align:center;}
.mega-menu-wrapper.d-flex {padding-bottom:3rem; justify-content:start; gap:0 30px; max-width:1600px; margin:auto}
.card.card-mn {min-height:unset; padding:0; margin-top:1em}

PDF exclude - start

To submit feedback about this documentation, visit our community forum.

PDF exclude - end

@@ Line 1: / Line 1: @@
 {{DISPLAYTITLE:Custom menu}}
 ==Overview==
-In BlueSpice 4, an additional custom menu is integrated as a mega menu. This menu can be created and edited by users with admin rights. The link-icon (1) is only displayed once the corresponding page has been created.
+For further navigation support, a custom menu is integrated as a mega menu and can be customized by administrators.
-[[File:Manual:customMenu-view-EN.png|alt=Custom menu screenshot|center|thumb|750x750px|Custom menu: (1) open menu, (2) edit link, (3) menu items]]
-==Visual edit mode==
+==Creating a custom menu with the menu editor==
-{{BSVersion|bsvFrom=4.2|bsvTo=|bsvFeature=Visual menu editor}}
+If the custom menu icon is not yet displayed, first create the <code>MediaWiki:CustomMenu/Header</code> page.
-'''Click''' ''Edit menu'' (2) to switch to edit mode.
+'''From BlueSpice''' {{Bsvs|bsvFrom=5.1.2}}: The display of the custom menu button can be controlled via the configuration management (''Global Actions > Configuration >'' Skinning. There, activate or deactivate the checkbox for ''BlueSpiceCustomMenu'').
-If you are just starting out with the custom menu, you can start by editing the default ''Nav Menu'' item.
+If the menu already exists: Click ''Edit Menu'' to switch to edit mode.
-[[File:BlueSpiceCustomMenu navmenu item.png|alt=editing interface|center|thumb|'''editing interface:''' menu header (1), edit header name (2), add link to heading (3), add new menu header (4)]]
+[[File:Manual:customMenu-view-EN.png|alt=Custom menu: open menu, edit link and menu items|center|thumb|750x750px|Custom menu: open menu, edit link and menu items]]
-'''To  edit the NavMenu item:'''
+If the menu page does not exist, a message will be displayed:
+[[File:Extension BlueSpiceCustomMenu page does not exist.png|alt=Message indicating that the page MediaWiki:CustomMenu/Header does not exist|center|thumb|750x750px|Missing menu page]]
-#'''Click''' the icon for opening the edit dialog. (1)
+In this case, you can easily create the menu by editing the page. Alternatively, you can also use the "Edit menu" link in the mega menu.
-#'''Click''' ''Edit Node.''
-#'''Enter''' the text for your menu header. In a multilingual wiki, you can also enter a [[mediawikiwiki:Help:System_message|message key]].
-{{#dpl: title=Manual:Extension/BlueSpiceDiscovery/Main_navigation|include=menulinks}}
+==Menu editor==
+[[Manual:Extension/MenuEditor|View instructions on the menu editor help page.]]
-== <span class="mw-headline">Adding links in source editing mode</span> ==
-'''To create a menu header:'''
-#'''Create''' the first menu header. Menu headers are marked with a single asterisk (*);<syntaxhighlight lang="text">
-* Important pages
-</syntaxhighlight>
-#'''Add''' the links for this menu header. Links are marked with two asterisks (**) and have the following syntax:<syntaxhighlight lang="text">
-** target page|label
-</syntaxhighlight>
-'''Example:'''<pre>* Important pages
-** Special:Blog|Blog
-** IMS:Policies|Policies
-* BlueSpice
-** https://bluespice.com|BlueSpice Homepage
-** https://bluespice.com/category/news-know-how|News</pre>
-After the custom menu has been created, it can now be modified directly via the ''Edit menu'' link (see screenshot above).
 ==Delete the custom menu==
 To remove the custom menu link-icon from the wiki, the <code>MediaWiki:CustomMenu/Header</code> page must be deleted. The page can be restored via the deletion log.
-{{Box Links-en|Topic1=[[Manual:Extension/BlueSpiceDiscovery/Main_navigation|Customize the main navigation]]|Topic2=[[Manual:Extension/BlueSpiceUserSidebar|Customize the user menu]]|Topic3=[[Reference:BlueSpiceCustomMenu]]}}
+== Layout for many columns ==
+If you're building a menu with many columns, the following CSS adjustment may be helpful. On the Flexiskin special page, enter the following CSS declarations in the "Free CSS" text area:
+<syntaxhighlight lang="css">
+.navbar-nav .dropdown-menu {text-align:center;}
+.mega-menu-wrapper.d-flex {padding-bottom:3rem; justify-content:start; gap:0 30px; max-width:1600px; margin:auto}
+.card.card-mn {min-height:unset; padding:0; margin-top:1em}
+</syntaxhighlight>
+{{Box Links-en
+|Topic1=[[Manual:Extension/MenuEditor|Menu Editor]]
+|Topic2=[[Manual:Extension/BlueSpiceDiscovery/Main_navigation|Customize the main navigation]]
+|Topic3=[[Manual:Extension/BlueSpiceUserSidebar|Customize the user menu]]}}
 {{Translation}}
 [[Category:Customization]]