Difference between revisions of "Manual:Extension/BlueSpiceUserSidebar"

            
            
            <bs:bookshelf src="Book:User manual" />
            
            
            
            __TOC__
            
            
            
            ==What is BlueSpiceUserSidebar?==
            
            
            
            '''BlueSpiceUserSideBar''', previously known as "Focus sidebar", {{DISPLAYTITLE:Personal navigation}}
            
            
            
            The extension '''UserSideBar''' lets users create their own personal sidebar navigation.
        
        
        
        ==Where to find BlueSpiceUserSidebar?Accessing the personal navigation==
        
        [[File:UserSidebar1a.png|thumb|alt=Personal navigation|center|650x650px|Personal navigation]]
        
        Every logged-in user has their own UserSidebar. It is located in the left navigation, as the "''Personal navigation"'' tab (clipboard icon).
        
        
        
        ==Usage==
            
            InitialyDefault content==
            
            Initially, for users who havent yet haven't customized their personal sidebar, it will show the navigation shows the following widgets:
        
        
        
        *Pages Visitedvisited (widget PAGESVISITED): A list of pages user has recently visited.
            
            
        
            
            
        *My edits (widget YOUREDITS): A list of pages user recently edited.
            
            *Watchlist (widget WATCHLIST): The list of pages user is watching.
            
            
            
            These widgets are predefined lists of pages, universaly useful for many users. These widgets can be used when user customizes their sidebar.
            
            
            
            ===Customizing sidebar===
            
            [[File:UserSidebar2a.png|thumb|Edit sidebar button]]
            
            In order to 
            
            *Watchlist (widget WATCHLIST)
            
            
            
            These widgets can be removed individually when a user customizes the sidebar.
            
            
            
            ==Customizing the sidebar==
            
            To customize the content of this sidebar, click on "''Edit sidebar" button '' at the bottom of the sidebar. This button is only visible when hovering over the sidebar.
            
            The user sidebar can also be customized by visting <nowiki>User:{username}/Sidebar</nowiki>. The page "Sidebar" is dedicated subpage of every user's user page and holds content of the sidebar.
            
            
            
            New users, when first visiting this page, may have to create the page first.
            
            
            
            ===Adding custom content===
            
            
         after hovering over any menu item. This opens the page ''User:<username>/Sidebar''. 
            
            
            
            
        The syntax used to define the sidebar is same as the one used in corresponds to the main MediaWiki sidebar (<nowiki>MediaWiki:Sidebar</nowiki>). EntiesEntries starting with a single star ("*") will be are considered menu headings or sections while entries with two stars ("**") will be are considered actual entries.
            
            To create sidebar that will show section "My favourite pages" and have links to Page1 and Page2 in it, correct syntax would be:
            
            
        menu items.
            
            
        <pre>
        
        * My favourite pages
        
        ** [[Wiki_Page1]]
            
            ** [[Page2]]|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>
            
            
            
            Available widgets are:
            
            
            
            *PAGESVISITED
            
            *YOUREDITS
            
            *WATCHLIST
            
            
            
            ==See also==
            
            [[Reference:UserSideBar|Reference page]] for this extension.{{Box Links-en|Topic1=[[Reference:BlueSpiceUserSidebar]]}}
            
            {{Translation}}
            
            __FORCETOC__
            
            [[Category:Personalization]]