Extension: BlueSpiceCustomMenu

Description: Provides customizable menus
State: stable Dependency: BlueSpice
Developer: Licence: GPL v3 only
Type: Category: Search and Navigation
Edition: BlueSpice pro, BlueSpice free, BlueSpice Farm, BlueSpice Cloud


CustomMenu is a menu with configurable items.

Usage / features

CustomMenu is implemented as header menu with flyout child menus. It appears as collapsible menu above the top navigation bar. The HTML output is an unordered list. CustomMenu is enabled by default.

Menu items can be modified by editing the MediaWiki:CustomMenu/Header.


* html ID (has to be unique) | target page | label (optional)

The html ID can be used to apply CSS rules in MediaWiki:Common.css.


1. A link to the Wiki page 'Intranet':

* menuLink1 | Intranet

The html ID 'menuLink1' is used to display the menu item, because no label has been specified.

2. A link to the Wiki page 'Intranet'. The visible label is 'Our Intranet':

* menuLink1 | Intranet | Our Intranet

3. A Dropdown with link to the Wiki pages 'Intranet' and 'Demo'. The visible label of the menu is 'Hello World'. The dropdown contains 'Our Intranet' and 'Demo':

 * Hello World  
 ** menuLink1 | Intranet | Our Intranet  
 ** demoLink | | Demo

Technical information

BlueSpiceCustomMenu will be hidden on mobile devices. The width is restricted to the content width. It is limited to one line.

By default, there are only 2 menu levels (link text and one dropdown). More levels can be set, but it is tested only up to level 3. We recommend not to use more levels. Menu may be outside the window!


Name Default value Override by
$bsgCustomMenuHeaderNumberOfLevels 2 $bsgOverrideCustomMenuHeaderNumberOfLevels
$bsgCustomMenuHeaderNumberOfMainEntries 10 $bsgOverrideCustomMenuHeaderNumberOfMainEntries
$bsgCustomMenuHeaderNumberOfSubEntries 10 $bsgOverrideCustomMenuHeaderNumberOfSubEntries