Navigation

The main navigation can be found on the left side of the wiki page. This bar contains the navigation, every use user can see and use (in contrast to the Focus, which can be customized from the user as individual and personal navigation). To change the main navigation, you need to have administrator rights. Besides: in the navigation bar, you can link important areas and portals (like departments or main topics).

Fold navigation in and out

Since the BlueSpice version 2.22.0 you have the possibility to fold the navigation in and out. Just click on the white arrows on top of the navigation bar.

Screenshot: Die ausgeklappte Navigation mit allen Informationen

Screenshot: Die eingeklappte Navigation mit Icons als Hinweis

Change the content of the navigation

You can find the code of the navigation bar on this page:

MediaWiki:Sidebar

You can also go to Special pages -> System messages -> sidebarIf you have the administratior right, also a link "Edit sidebar" will be shown at the bottom of the navigation panel.

Coding

If you take a look at MediaWiki:Sidebar, you may see that it is a list. * is a header and ** a list item under the header.

The list items are like normal wiki links. The first part after the ** is the name of the page, you want to link to. In normal wiki code, this name is in brackets, e.g. [Testpage]. You don´t need this these brackets here. Just type in the name of the page. The second part after the | is the description, this means it´s the text which will be shown in the navigation.

Example:

                * Navigation
** Main_Page|Main page
** Special:AllPages|From A to Z 
* Enterprise
** Company|Company
** Staff|Staff
** Sales and Marketing|Sales, Marketing, Projectmangement
** Products and services|Products 
** Category:Organisation|Customers and Organisationen

            

Note: It is not possible to create subitems in the navigation bar and also linking to a file doesn´t work, because the Sidebar can´t interpret this kind of links.

Insert icons in the navigation

Starting with version 2.22.0 you can add icons. To do this, follow these steps:

Go to the special page Special:Upload. Upload the icons, you want to use. Note: An icon should have a size of 24px x 24px. Recommended formats are .jpg, .png

You can assign individual icons to the navigation points by adjusting the styling using CSS.

To do so, proceed as follows:

Suppose you have created a menu item "Hints" as described above and now want to equip it with an appropriate icon.

• Open the page MediaWiki:Sidebar and put behind the menu item a pipe ("|") and write behind the file name of the icon. Then save.

                  * Recentchanges-url | Recent Changes | Icon-for-recent-changes.png

            

• Refresh the page by pressing F5, then should your icons appear in the menu.Common.css in edit mode.
• Add the following lines to the end of the page and save:

                #n-Hints i::before {
    content: '\e90e';
    font-family: 'entypo';

            

• To make the change visible, it is usually necessary to empty the browser cache.

Please note that the display name (in this case "Hints") and not the page title must be used here; spaces must be replaced by hyphens ("-").

When special characters are used, there may be difficulties because they are converted in the HTML code of the page. In such a case, right-click on the corresponding entry and, depending on the browser used, select "Examine element" or similar. You will now see the underlying source code and should see a part that has this form:

                <a id="n-MENUENTRY" class="list-group-item" ..... >
            

In the above example, replace #n-Hints with #n-MENUENTRY.

You can see all available icons on the page ../extensions/BlueSpiceFoundation/resources/bs.icons.php of your wiki. Here you find an overview of the symbols available in this particlar wiki.

In the upper line you can click through different fonts, below you find the icons with the corresponding character keys. In MediaWiki:Common.css you have to adjust the entries font-family (font) and content (character key) accordingly.