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==
+For further navigation support, a custom menu is integrated as a mega menu and can be customized by administrators.
-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.
+==Creating a custom menu with the menu editor==
-==Create the custom menu==
+If the custom menu icon is not yet displayed, first create the <code>MediaWiki:CustomMenu/Header</code> page.
-[[File:Manual:customMenu-view-EN.png|alt=Custom menu screenshot|center|thumb|750x750px|Custom menu: (1) open menu, (2) edit link, (3) menu items]]
+'''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 the menu already exists: Click ''Edit Menu'' to switch to edit mode.
+[[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]]
+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]]
+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==
+[[Manual:Extension/MenuEditor|View instructions on the menu editor help page.]]
-'''To create the menu :'''
-#'''Open''' the page <code>MediaWiki:CustomMenu/Header</code>.
-#'''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">
-** unique ID|target page|label
-</syntaxhighlight>
-'''Example:'''<pre>* Important pages
-** Blog|Special:Blog
-** Policies|IMS:Policies
-* BlueSpice
-** BlueSpice Homepage|https://bluespice.com/
-** News|https://bluespice.com/category/news-know-how/</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]]