Manual:Extension/BlueSpiceUserSidebar: Difference between revisions

No edit summary
No edit summary
 
(9 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{DISPLAYTITLE:Personal navigation}}
{{DISPLAYTITLE:Personal navigation}}


The extension '''UserSideBar''' lets users create their personal sidebar navigation.
==Accessing the personal navigation==
Every logged-in user has their own user menu. Changes to this menu are only visible to the individual user.  
 
[[File:UserSidebar screenshot.png|alt=elements of the user sidebar|center|thumb|850x850px|(1) profile image, (2) user menu edit link, (3) customizable links, (4) Personal Tools]]


==Accessing the personal navigation==
The menu  is separated in two sections (see screenshot):
[[File:UserSidebar1a.png|thumb|center|650x650px|Personal navigation|link=Special:FilePath/UserSidebar1a.png]]
Every logged-in user has their own UserSidebar. It is located in the left navigation as the ''Personal navigation'' tab (clipboard icon).


==Default content==
* Customizable links 
Initially, for users who haven't customized their personal sidebar, the navigation shows the following widgets:
* Personal tools (these links cannot be edited)


==Customizing the sidebar==
Initially, the customizable links show the following widgets:
*Pages visited (widget PAGESVISITED)
*Pages visited (widget PAGESVISITED)
*My edits (widget YOUREDITS)
*My edits (widget YOUREDITS)
These widgets can be removed individually.


These widgets can be removed individually when a user customizes the sidebar.


==Customizing the sidebar==
'''To customize the content of the user menu:'''
To customize the content of this sidebar, click on ''Edit sidebar'' at the bottom of the sidebar after hovering over any menu item. This opens the page ''User:<username>/Sidebar''.
 
# '''Click''' on your user profile image.
# '''Click''' ''Edit user menu.''
 
===Menu editor===
{{#dpl: title=Manual:Extension/BlueSpiceDiscovery/Main_navigation|include=#Menu editor}}


The syntax used to define the sidebar corresponds to the main MediaWiki sidebar (<nowiki>MediaWiki:Sidebar</nowiki>). Entries starting with a single star ("*") are considered menu headings or sections while entries with two stars ("**") are considered menu items.
===Source edit mode===
<pre>
{{#dpl: title=Manual:Extension/BlueSpiceDiscovery/Main_navigation|include=#Source edit mode}}
* My favourite pages
** Wiki_Page1|Label
** External_Page2 Label
</pre>


The sidebar can contain multiple sections.
Also, users can use widgets to display predefined lists of pages, as described above. Widgets should be inserted as sections (with one star), like:
<pre>
* WATCHLIST
* My custom section
** [[Page1]]
...
</pre>{{Box Links-en|Topic1=[[Reference:BlueSpiceUserSidebar]]}}
{{Translation}}
{{Translation}}
__FORCETOC__
[[Category:Personalization]]
[[Category:Personalization]]

Latest revision as of 13:59, 7 March 2023


Accessing the personal navigation

Every logged-in user has their own user menu. Changes to this menu are only visible to the individual user.

elements of the user sidebar
(1) profile image, (2) user menu edit link, (3) customizable links, (4) Personal Tools

The menu is separated in two sections (see screenshot):

  • Customizable links
  • Personal tools (these links cannot be edited)

Customizing the sidebar

Initially, the customizable links show the following widgets:

  • Pages visited (widget PAGESVISITED)
  • My edits (widget YOUREDITS)

These widgets can be removed individually.


To customize the content of the user menu:

  1. Click on your user profile image.
  2. Click Edit user menu.

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;



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