Manual:Extension/BlueSpiceDiscovery/Main navigation: Difference between revisions

Redaktion (talk | contribs)
Changed categories.
Redaktion (talk | contribs)
No edit summary
Tag: 2017 source edit
 
(25 intermediate revisions by 2 users not shown)
Line 1: Line 1:
==How does the main navigation work?==
{{DISPLAYTITLE:Main navigation}}
By default, some links are provided as entry points to the wiki. Wiki administrators can deactivate these links in the [[Manual:Extension/BlueSpiceConfigManager|configuration manager]] if needed. In addition, custom links can be added here. Please note that no hierarchical links can be created. Therefore, it makes sense to mainly set up links to the most important topics and to  portal pages that contain additional links or page lists.
==Overview==
[[File:Manual:skin-discovery-hauptnavigation-EN.png|alt=Main navigation|center|thumb|402x402px|Main navigation]]
The main navigation is the main (left) sidebar in the desktop view of the wiki. The contents of this navigation bar apply to the entire wiki and cannot be created for specific [[Manual:The concept of namespaces|namespaces]].


==Adding links==
Links can be added to this navigation. To keep the main navigation from becoming too extensive, it's a good idea to add links to the most important topics and to related [[Manual:Startpage templates|portal pages]].




'''To add new links:'''
By default, some links are provided as entry points to the wiki. Wiki administrators can deactivate these links in the [[Manual:Extension/BlueSpiceConfigManager|configuration manager]] if needed. In addition, you can also add new links below the entrypoints (admin permissions required). Please note that no hierarchical links can be created. Therefore, it makes sense to mainly set up links to the most important topics and to  portal pages that contain additional links or page lists.
[[File:Manual:main_nav_4-4.png|alt=Entry links and custom links|center|thumb|368x368px|Main navigation]]


#'''Open''' the page ''MediaWiki:Sidebar'' from the browser's address bar.
== ​Deactivating entrypoint links ==
#'''Change''' to edit mode.
In a new wiki, some standard links are displayed under the heading "Entrypoints." These may vary depending on the BlueSpice version and can be enabled or disabled via the [[Manual:Extension/BlueSpiceConfigManager|configuration manager]] menu item ''Skinning.''  
#'''Create''' one or more navigation links (with or without section heading).  The following example shows a link to the page "Company" with the label "Our company" and an external link to the BlueSpice website with the label "Website". The links are grouped together under the section heading "Quicklinks":<syntaxhighlight lang="text">
*Quicklinks
**Company|Our company
**https//www.bluespice.com/de|Website
</syntaxhighlight>
#'''Save''' the page. The links are now shown in the main navigation.


{{Messagebox|boxtype=note|icon=|Note text=As soon as you have created at least one additional link, a direct edit link to the ''MediaWiki:Sidebar'' page is displayed when you move the mouse over such a link (see screenshot above).|bgcolor=}}
== Choosing a menu type for the main navigation ==
<span style="color: rgb(51, 51, 51)">Link labels may collide with system messages. If this is the case, simply append the HTML-code for an empty space to the description:</span><syntaxhighlight lang="text">
In the configuration manager, you can choose between four menu settings:  
**Portal|Portal&#160;
</syntaxhighlight>
==Deacivating standard links==
The standard links can be deactivated in the [[Manual:Extension/BlueSpiceConfigManager|configuration manager]]. The following settings are available under ''Feature > Skinning'':


# [[Manual:Extension/BlueSpiceDiscovery/Main navigation#MediaWiki sidebar|MediaWiki sidebar]]: A simple list of links to wiki pages (often to portal pages). A hierarchical navigation structure is not supported.
# Namespace main page list: Automatically creates links to all pages in the wiki using the syntax namespace prefix:mainpage (e.g., QM:mainpage).
# Subpage tree: Useful in a wiki that primarily structures pages using subpages.
# [[Manual:Extension/BlueSpiceDiscovery/Main navigation#Enhanced MediaWiki sidebar|Enhanced MediaWiki sidebar]]: A list of links to wiki pages. A hierarchical navigation structure is supported. Pages can be displayed with their subpage structure expanded.


BlueSpiceBookshelf:
== Editing the main navigation ==
If you have set your navigation type to ''MediaWiki Sidebar'' or ''Extended MediaWiki Sidebar'', your custom navigation links are created using the menu editor. A new wiki installation may already have some links created. You can delete these using the menu editor.
[[File:Main navigation Getting started.png|alt=Getting Started menu with four default links|center|thumb|200x200px|Standard custom links in the main navigation]]


* Show entrypoint "Bookshelf"


BlueSpiceDiscovery:
[[Manual:Extension/MenuEditor|View instructions on the menu editor help page.]]


*Show entrypoint "Mainpage"
{{Box Links-en|Topic1=[[Manual:Extension/BlueSpiceDiscovery/Main navigation/Long link labels|Alignment for navigation with long link labels]]|Topic2=[[Manual:Extension/BlueSpiceDiscovery/Main navigation/Icons|Display icons with navigation links]]|Topic3=[[Manual:Extension/BlueSpiceDiscovery/Main navigation/Language support|Multi-language navigation]]}}
*Show entrypoint "All pages"
*Show entrypoint "Recent changes"
 
BlueSpiceSocial:
 
*Show entrypoint "Timeline"
 
BlueSpiceSocialBlog:
 
*Show entrypoint "Blog"
 
==Gruppenspezifische Navigation==
<span style="color: rgb(51, 51, 51)">It is possible to show navigation elements for specific user groups only. Please note that the pipe symbol (|) between the page name and its label has to be escaped as</span> <code><nowiki>{{!}}</nowiki></code> <span style="color: rgb(51, 51, 51)">within this function.</span>
 
This syntax is defined in the extension [[Reference:UserFunctions|UserFunctions]].<syntaxhighlight lang="text">
{#ifingroup:sysop,widgeteditor |
*Test2                     
**somepage{{!}}Some page
|}}
</syntaxhighlight>
 
==Additional customizations==
 
*[[Manual:Extension/BlueSpiceDiscovery/Main navigation/BlueSpiceDiscovery/Main navigation/Icons|Display icons with navigation links]]
*[[Manual:Extension/BlueSpiceDiscovery/Main navigation/Language support|Multi-language navigation]]
 
<br />
[[Category:Administration]]
[[Category:Administration]]
[[Category:Customization]]
[[Category:Customization]]
[[de:Handbuch:Erweiterung/BlueSpiceDiscovery/Hauptnavigation anpassen]]

Latest revision as of 10:11, 21 May 2025

Overview

The main navigation is the main (left) sidebar in the desktop view of the wiki. The contents of this navigation bar apply to the entire wiki and cannot be created for specific namespaces.

Links can be added to this navigation. To keep the main navigation from becoming too extensive, it's a good idea to add links to the most important topics and to related portal pages.


By default, some links are provided as entry points to the wiki. Wiki administrators can deactivate these links in the configuration manager if needed. In addition, you can also add new links below the entrypoints (admin permissions required). Please note that no hierarchical links can be created. Therefore, it makes sense to mainly set up links to the most important topics and to portal pages that contain additional links or page lists.

Entry links and custom links
Main navigation

​Deactivating entrypoint links

In a new wiki, some standard links are displayed under the heading "Entrypoints." These may vary depending on the BlueSpice version and can be enabled or disabled via the configuration manager menu item Skinning.

Choosing a menu type for the main navigation

In the configuration manager, you can choose between four menu settings:

  1. MediaWiki sidebar: A simple list of links to wiki pages (often to portal pages). A hierarchical navigation structure is not supported.
  2. Namespace main page list: Automatically creates links to all pages in the wiki using the syntax namespace prefix:mainpage (e.g., QM:mainpage).
  3. Subpage tree: Useful in a wiki that primarily structures pages using subpages.
  4. Enhanced MediaWiki sidebar: A list of links to wiki pages. A hierarchical navigation structure is supported. Pages can be displayed with their subpage structure expanded.

Editing the main navigation

If you have set your navigation type to MediaWiki Sidebar or Extended MediaWiki Sidebar, your custom navigation links are created using the menu editor. A new wiki installation may already have some links created. You can delete these using the menu editor.

Getting Started menu with four default links
Standard custom links in the main navigation


View instructions on the menu editor help page.

Related info



PDF exclude - start

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

PDF exclude - end