2 Customizing the main navigation

The user interface provides 3 customizable menus: [[#Main navigation|Main navigation,]] [[#Custom menu|Custom menu]], [[#User menu|User menu.]] All of them can be edited with the menu editor.

== Main navigation ==
The main navigation is displayed on all content pages in the wiki and does not change in individual namespaces.

Up to v.4.2, only the standard [[#MediaWiki sidebar|MediaWiki sidebar]] is available.{{#dpl:title=Manual:Extension/BlueSpiceDiscovery/Main navigation|include=#Overview}}{{RefLink|page=Manual:Extension/BlueSpiceCustomMenu#Visual_edit_mode|label=Editing the main navigation (v.4.1-4.2)}}

=== Menu types for the main navigation{{Bsvs|bsvFrom=4.3|bsvTo=|bsvFeature=}}===
Starting at BlueSpice 4.3, four different menu settings are available. Administrators can select a menu type in the [[Manual:Extension/BlueSpiceDiscovery|Config manager]].

==== MediaWiki sidebar ====
This is the standard view of the sidebar.  It displays custom menu items with no hierarchical structure. If you need a more flexible menu, switch to the [[#Enhanced MediaWiki sidebar|Enhanced MediaWiki sidebar]].

{{RefLink|page=Manual:Extension/BlueSpiceDiscovery/Main_navigation|label=Editing the standard main navigation}}

==== Namespace main page list====
This view automatically displays the Main Page of each content namespace.

* No combination with other menu elements is possible.

==== Subpage tree (context-sensitive)====
This view automatically shows the subpages  of a page if that page has subpages. Multi-level subpages are supported.

* No combination with other menu elements is possible.

==== Enhanced MediaWiki sidebar====
This view shows a fully customizable multi-hierarchical menu. Here, you edit the page MediaWiki:Sidebar.json. It has the basic functionality of the [[#MediaWiki sidebar|standard MediaWiki sidebar]]. In addition, it distinguishes between the following sub elements (=node types):

* Internal Link
** Simply provide a link to a wiki page with an additional link label. Both the page name and/or label can be created by using a parser function.<br />  [[File:EnhancedMenuEditor-internal link.png|alt=Internal link with a variable.|center|thumb|550x550px|Internal link with a variable.]]
* External Link
** Same as internal link, but you need to provide a full url to an external website.
* Subpage tree
** You can provide the name of a page that has one or more levels of subpages. You can set the depth <code>6</code> levels deep with the parent page being the first level. This means, that if you want to show the first level of subpages, you would select a depth of <code>2</code>.<br />
[[File:EnhancedMenuEditor-subpage tree.png|alt=Screenshot of the edit window for a subpage tree item.|center|thumb|550x550px|Creating a subpage tree with the Enhanced MenuEditor.]]

It is not possible to change the node type (=item type) after creating it. Instead, create a new item as needed and delete the unwanted item.

=== Show for groups ===
In addition, the visibility of a menu item can be limited to certain wiki groups. Enter a comma-separated list of existing wiki groups in the "Show for groups" field.

=== Css classes ===
You can also apply css classes to any item for custom styling options. The styles need to be defined on the page <code>MediaWiki:Common.css.</code>


== Custom menu ==
{{#dpl:title=Manual:Extension/BlueSpiceCustomMenu|include=#Overview}}{{RefLink|page=Manual:Extension/BlueSpiceCustomMenu#Visual_edit_mode|label=Editing the custom menu}}

== User menu ==
{{#dpl:title=Manual:Extension/BlueSpiceUserSideBar|include=#Overview}}

{{RefLink|page=Manual:Extension/BlueSpiceUserSideBar#Visual_edit_mode|label=Editing the user menu}}

{{translation}}