Manual:Extension/BlueSpiceCustomMenu: Difference between revisions

No edit summary
Tag: 2017 source edit
No edit summary
 
(5 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{DISPLAYTITLE:Custom menu}}
{{DISPLAYTITLE:Custom menu}}
 
==Overview==
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.
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.
[[File:Manual:customMenu-view-EN.png|alt=Custom menu screenshot|center|thumb|750x750px|Custom menu: (1) open menu, (2) edit link, (3) menu items]]


==Visual edit mode==
If you don't see the menu icon in your wiki, create the following page: <span style="color: rgb(37, 37, 37); font-family: monospace, Courier; font-size: 13.125px; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: 2; text-align: left; text-indent: 0px; text-transform: none; white-space: normal; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; background-color: rgb(233, 233, 238); text-decoration-thickness: initial; text-decoration-style: initial; text-decoration-color: initial; display: inline !important; float: none;">MediaWiki:CustomMenu/Header</span>
{{BSVersion|bsvFrom=4.2|bsvTo=|bsvFeature=Visual menu editor}}


'''Click''' ''Edit menu'' (2) to switch to edit mode.
[[File:Manual:customMenu-view-EN.png|alt=Custom menu screenshot|center|thumb|750x750px|Custom menu: (1) open menu, (2) edit link, (3) menu items]]
 
If you are just starting out with the custom menu, you can start by editing the default ''Nav Menu'' item.
[[File:BlueSpiceCustomMenu navmenu item.png|alt=editing interface|center|thumb|'''editing interface:''' menu header (1), edit header name (2), add link to heading (3), add new menu header (4)]]
 
 
'''To  edit the NavMenu item:'''


#'''Click''' the icon for opening the edit dialog. (1)
==Menu editor==
#'''Click''' ''Edit Node.''
{{#dpl: title=Manual:Extension/BlueSpiceDiscovery/Main_navigation|include=#Menu editor}}
#'''Enter''' the text for your menu header. In a multilingual wiki, you can also enter a [[mediawikiwiki:Help:System_message|message key]].


{{#dpl: title=Manual:Extension/BlueSpiceDiscovery/Main_navigation|include=menulinks}}
==Source edit mode==
{{#dpl: title=Manual:Extension/BlueSpiceDiscovery/Main_navigation|include=#Source edit mode}}


== <span class="mw-headline">Adding links in source editing mode</span> ==
'''To create a menu header:'''
#'''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">
** target page|label
</syntaxhighlight>
'''Example:'''<pre>* Important pages
** Special:Blog|Blog
** IMS:Policies|Policies
* BlueSpice
** https://bluespice.com|BlueSpice Homepage
** https://bluespice.com/category/news-know-how|News</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==
==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.
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]]}}
{{Box Links-en|Topic1=[[Manual:Extension/BlueSpiceDiscovery/Main_navigation|Customize the main navigation]]|Topic2=[[Manual:Extension/BlueSpiceUserSidebar|Customize the user menu]]}}
{{Translation}}
{{Translation}}
[[Category:Customization]]
[[Category:Customization]]

Latest revision as of 10:16, 20 March 2023

Overview

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.

If you don't see the menu icon in your wiki, create the following page: MediaWiki:CustomMenu/Header

Custom menu screenshot
Custom menu: (1) open menu, (2) edit link, (3) menu items

Menu editor

Visual menu editor is available from BlueSpice 4.2.


To add a new menu header using the menu editor:

  1. Click Add new element to create a new menu header.
    Add a new menu heading
    Add a new menu heading
  2. Enter the text for your menu header. In a multilingual wiki, you can also enter a message key.
    Enter a heading name
    Enter a heading name
  3. Click Done.

To add links:

  1. Select Add new subitem from the dropdown menu of the menu header.
    add a link
    add a link as a new subitem
  2. Enter the page name as the link target and the label that you want to show:
    enter link info
    enter link info
  3. Click Done.
  4. Repeat steps 1-3.
  5. Click Save changes.
Note:If you use the parser function {{#ifingroup:... to display navigation elements in the source code, you must always edit the main navigation in the source code. In visual editing mode, saving removes any parser function or semantic queries.


Source edit mode

To add new links:

  1. Change to source editing mode.
  2. 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":
    *Quicklinks
    **Company|Our company
    **https//www.bluespice.com/de|Website
    
  3. Save the page. The links are now shown in the main navigation.


Link labels may collide with system messages. If this is the case, simply append the HTML-code for an empty space to the description:

**Portal|Portal&#160;


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.

Related info



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