View source for Manual:Interface/Sidebar

<languages />
{{interface message}}

[[File:Example_sidebar.png|thumb|<translate><!--T:98--> Sidebar example</translate>]]
:<translate><!--T:182--> ''See also: [[<tvar name=1>Special:MyLanguage/Manual:Remove Tabs</tvar>|Manual:Remove Tabs]]''</translate>

<translate><!--T:1--> <tvar name=1>'''[[MediaWiki:Sidebar|MediaWiki:Sidebar]]'''</tvar> allows a user to modify the navigation bar.</translate>
<translate><!--T:180--> The navigation bar provides links to the most important locations in the wiki and supplies site administrators with a place to add an important collection of links.</translate>
<translate><!--T:181--> For instance, most wikis will link to their community discussion page and some useful tool pages.</translate>

<translate><!--T:2--> The Monobook and Vector [[<tvar name=1>Special:MyLanguage/Manual:Skins</tvar>|skins]] place the navigation bar on the top-left (top-right for right-to-left languages) along with the search bar and toolbox, but the placement may be different in other skins.</translate>
<translate><!--T:145--> This sidebar is '''not shown to users of the [[<tvar name=1>Special:MyLanguage/Mobile</tvar>|Mobile]] site''' (i.e. the version of the site produced by <tvar name=2>{{ll|Extension:MobileFrontend}} / {{ll|Skin:MinervaNeue}}</tvar> - use the <tvar name=3>{{ll|Extension:MobileFrontend/MobileMenu|MobileMenu}}</tvar> hook for that).</translate>

<translate>
==Customize the sidebar== <!--T:3-->
</translate>
<translate><!--T:4--> To customize the <tvar name=1>[[MediaWiki:Sidebar]]</tvar> on a wiki, you need first to be logged in with a user that has the ''editinterface'' permission. For administrators this is enabled by default.</translate><ref>
<translate><!--T:153--> (For information on assigning a permission to groups or users, see <tvar name=2>{{ll|Manual:User rights}}</tvar>.)</translate>

<translate><!--T:5--> Then, use a link to a page on your wiki, but replace your wiki page's title (e.g. <code>Main_Page</code>) in the URL/Address bar with <tvar name=1><code>MediaWiki:Sidebar</code></tvar> and load that page - you should now see the current content of the sidebar. (You may need to use the syntax <tvar name=2>''//yourdomain/yourwiki/index.php?title=MediaWiki:Sidebar&action=edit''</tvar> if you use long URLs.)</translate>

<translate><!--T:6--> If the content of the sidebar has already been modified, you can click on the ''Edit'' or ''Edit source'' link, otherwise you may need to create the page first by clicking on ''Create'' or ''Create source''.</translate>
</ref>

<translate><!--T:183--> You can access MediaWiki:Sidebar by either:</translate>

* <translate><!--T:184--> Going to <tvar name=1><nowiki>http://yourdomain/wiki/index.php?title=MediaWiki:Sidebar&action=edit</nowiki></tvar> in your browser.</translate>
* <translate><!--T:185--> Typing MediaWiki:Sidebar in search bar, and validating with Enter.</translate>
* <translate><!--T:186--> From Special:AllMessages, searching for "side".</translate>

<translate>
<!--T:8-->
Here is example code added in <tvar name=1>[[MediaWiki:Sidebar]]</tvar> for a sidebar:
</translate>

<pre>
* navigation
** mainpage|Accueil
** Special:RecentChanges|Recent changes
* new heading
** portal-url|Forums
** https://www.mediawiki.org|MediaWiki home
</pre>
{{-}}
<translate>
<!--T:9-->
This example will result in the following sidebar:
</translate>
[[File:Example_sidebar.png|{{dir|{{pagelang}}|right|left}}|thumb|<translate><!--T:99--> Sidebar example</translate>]]

{{-}}

{{note|1=<translate><!--T:7--> If you have to create a new page, you will be presented with the default content for the sidebar in the editor. In order to successfully create a MediaWiki:Sidebar page, you need to change the content before saving.</translate>}} 

<translate>
=== Splitting the navigation bar into new sections === <!--T:154-->
</translate>
<translate><!--T:11--> The navigation bar can be split into sections, each with a new heading of its own.</translate>
<translate><!--T:155--> This is done by adding one asterisk.</translate>

<translate><!--T:156--> The heading for each section is taken from the first-level list element ("navigation" and "new heading" in the example above).</translate>
<translate><!--T:12--> If this text corresponds to the name of an interface message (an existing page of that title in the MediaWiki namespace), then the text of that page is used as a label; otherwise, the header title is used as-is.</translate>
<translate><!--T:175--> Please note the <tvar name=1><code><nowiki>{{int:}}</nowiki></code></tvar> [[<tvar name=2>Special:MyLanguage/Help:Magic word#Localization</tvar>|magic word]] does not work since it is useless: MediaWiki automatically looks for a translation to display before to fallback to the default message.</translate>

<translate>
<!--T:176-->
In the example above, <tvar name=1><code>* navigation</code></tvar> and <tvar name=2><code>* new heading</code></tvar> are section headings.

=== Creating links in the sidebar=== <!--T:165-->
</translate>
<translate><!--T:187--> Links are created with 2 asterisks (called Second-level list elements).</translate>
<translate><!--T:188--> For example:</translate>

<pre>
** <translate nowrap><!--T:177--> target</translate>|<translate nowrap><!--T:178--> link text</translate>
</pre>

<translate>
<!--T:15-->
; target</translate>
<translate>
<!--T:111-->
: The link target can be the name of an interface message (page in the MediaWiki namespace) or wiki page, or an external link. In either case, the [[<tvar name=1>Special:MyLanguage/Help:Links</tvar>|link]] can be internal, interwiki, or external.</translate><ref>
<translate><!--T:157--> In some cases (such as links with the "&" character), an interface message is necessary. The link target cannot be made dependent on the interface language set in the preferences.</translate>
</ref>
: <translate><!--T:179--> Do the following to determine the target:</translate>
<translate>
<!--T:16-->
:# Get the target text.
:# If there is an existing or default interface message with that name, use the content of that message instead of the target text.
:# If the output from the previous step is a valid URL (beginning with http:// or other [[<tvar name=1>Special:MyLanguage/Manual:$wgUrlProtocols</tvar>|URL protocol]]), the link will point to that URL.
:# Otherwise, it will treat it as the link target of a wikilink (linking to that page name or interwiki). 
:# In case it would end up linking to '-', the whole entry is removed from the sidebar. (This is useful for removing an entry on all languages by changing the message holding the link).</translate>
<translate>
<!--T:17-->
: Examples:
</translate>
:* "<code>** '''portal-url'''|portal</code>" <translate><!--T:100--> uses the text of <tvar name=1>[[MediaWiki:Portal-url]]</tvar> (which contains "<tvar name=2>{{MediaWiki:Portal-url}}</tvar>").</translate> 
:* "<code>** '''<nowiki>https://www.mediawiki.org</nowiki>'''|MediaWiki home</code>" <translate><!--T:103--> links to <tvar name=url>https://www.mediawiki.org</tvar> since this is a valid URL.</translate>
:* "<code>** '''Special:RecentChanges'''|Recent changes</code>" <translate><!--T:101--> links to <tvar name=1>[[Special:RecentChanges]]</tvar>, since there is no interface message of that name and that is not a valid URL.</translate>
:* "<code>** '''w:Foo'''|Some interwiki page</code>" <translate><!--T:102--> links to [[w:Foo|w:Foo]] for the same reason.</translate>

<translate>
<!--T:18-->
; link text</translate>
<translate>
<!--T:112-->
: The link text can be the name of an interface message (page in the MediaWiki namespace) or plain text.</translate>
<translate>
<!--T:158-->
:* If the link text is the name of an existing or default interface message, the content of that message will be used. MediaWiki will check for localized versions; for example, if the current language is fr (French) and the link text is the interface message "forum", it will check for "forum/fr" before using "forum".</translate>
<translate>
<!--T:159-->
:* Otherwise, the link text is used as the target as-is.</translate>
<translate>
<!--T:160-->
:* Notice that the link text is '''not''' optional as in normal wiki links. If the link text is missing, <u>the item is ignored</u>. 

<!--T:19-->
: Examples:</translate>
:* <translate><!--T:139--> <code>** Homepage|'''mainpage'''</code> uses [[MediaWiki:Mainpage]] (which contains "{{:MediaWiki:Mainpage}}").</translate>
:* <translate><!--T:140--> <code>** Special:Recentchanges|'''Recent changes'''</code> uses "Recent changes", since there is no interface message of that name.</translate>

<translate>
===Section order (elements)=== <!--T:20-->
</translate>
<translate><!--T:189--> Some skins allow customizing the order of some special elements, like the search bar, toolbox, and languages.</translate>
<translate><!--T:190--> That can be done by adding the special keywords SEARCH, TOOLBOX and LANGUAGES respectively, to <tvar name=1>[[MediaWiki:Sidebar|MediaWiki:Sidebar]]</tvar> using the heading syntax.</translate>

<translate><!--T:191--> However, some skins like <tvar name=1>[[Special:MyLanguage/Skin:MonoBook|MonoBook]]</tvar> no longer support defining the position of the search element, and the search element is placed right after the first section of the sidebar instead.</translate>
<translate><!--T:192--> In that case, to move the search element at the top, the workaround is to define an empty leading section.</translate>
<translate><!--T:193--> For example:</translate>

<pre>
* empty section
* navigation
** mainpage|mainpage
** Special:Recentchanges|Recent changed
* new heading
** portal-url|portal
** https://www.mediawiki.org|MediaWiki home
</pre>

<translate><!--T:194--> Note that some skins may display the first section differently, or place some element between the first and the second section (if any).</translate>

<translate>
=== Tooltips and Accesskey === <!--T:113-->

<!--T:166-->
A tooltip is a message which appears when a cursor is positioned over an icon, image, hyperlink, or other element in a graphical user interface.

<!--T:114-->
If you add an item to the sidebar, it will have no "tooltip". But you can create a tooltip by doing the following:<ref>http://www.kaarebmikkelsen.dk/?p=174</ref>

<!--T:161-->
* create a wiki page named "MediaWiki:Tooltip-n-&lt;id of the item>"</translate>
<translate>
<!--T:162-->
* and put the tooltip in that page.

<!--T:167-->
An access key or accesskey allows a computer user to immediately jump to a specific part of a web page via the keyboard.

<!--T:115-->
Accesskeys can also be created by doing the following:

<!--T:116-->
* create a wiki page named "MediaWiki:Accesskey-n-&lt;id of the item>"
* and put the accesskey in that page.

<!--T:117-->
Example:

<!--T:118-->
* <code>* Homepage|mainpage-description</code> uses [[MediaWiki:Tooltip-n-mainpage-description]] and [[MediaWiki:Accesskey-n-mainpage-description]].

== Translations == <!--T:23-->

<!--T:24-->
You can translate the strings, which you use, by editing the according pages in the MediaWiki namespace.

<!--T:25-->
'''Example:''' The string, which will replace the item named "mainpage", is taken from [[MediaWiki:Mainpage|MediaWiki:Mainpage]]. To set/change this text for users, who display your wiki in German, you can put the according text on the page [[MediaWiki:Mainpage/de|MediaWiki:Mainpage/de]].

<!--T:26-->
That way you can easily translate these texts through the MediaWiki interface.

<!--T:27-->
'''Please note''' that MediaWiki will by default use the content of the Sidebar page in ''that'' language, which corresponds to the default language of your wiki. So, if your wiki e.g. uses French as its default language, edit [[MediaWiki:Mainpage/fr|MediaWiki:Mainpage/fr]] in order to show a modified sidebar to all users, who have not changed their language setting and to all anonymous users.

<!--T:28-->
For more advanced translation, see <tvar name=1>{{ll|Help:Extension:Translate/Unstructured element translation}}</tvar>.

==Advanced customization== <!--T:29-->

<!--T:30-->
The sidebar can be fully customized by implementing [[w:JavaScript|JavaScript]] or [[w:Cascading Style Sheets|Cascading Style Sheets]], or by editing the [[w:PHP|PHP]] files directly. Before using these methods, note that:

<!--T:163-->
* JavaScript is fragile: it will not work for users with JavaScript disabled, and scripts frequently fail in different browsers or skins.</translate>
<translate>
<!--T:164-->
* Editing the PHP files can easily cause unexpected errors, and your changes will be lost in the next update unless you manually change the new files.

=== Remove the Sidebar and main logo  at MediaWiki:Sidebar  === <!--T:168-->
</translate>
<translate><!--T:195--> To completely remove the sidebar and logo:</translate>

<translate><!--T:196--> Blank the '''MediaWiki:Sidebar''' page and save.</translate>

<translate><!--T:197--> Then add:</translate>

<syntaxhighlight lang="css">
#column-content { margin: 0 0 1em 0; }
#content { margin: 0 0 0 0; }
#p-cactions { left: .1em; }
</syntaxhighlight>

<translate>
<!--T:169-->
This moves the main text of your wiki to the left.

=== Completely remove  the sidebar, tabs and search bar === <!--T:170-->
</translate>
:<translate><!--T:198--> ''See also: [[<tvar name=1>Special:MyLanguage/Manual:Remove_Tabs</tvar>|Manual:Remove Tabs]]''</translate>

<translate>
<!--T:171-->
Deletes the logo, and the entire sidebar:
</translate>

 #p-logo, .generated-sidebar, #p-lang, #p-tb  { display:none; }

<translate>
<!--T:172-->
Deletes the search bar:
</translate> 

 #p-search { display:none; }

<translate>
<!--T:173-->
Deletes the talk tab:
</translate>

 #ca-talk { display:none!important; }

<translate>
<!--T:174-->
Deletes the Page tab:
</translate>

 #ca-nstab-main { display:none!important; }

<translate>
===Force UI-messages to follow content=== <!--T:31-->

<!--T:32-->
Some pages should sometimes follow the content language, especially for multilingual sites. This can be controlled with the setting <tvar name=1>{{ll|Manual:$wgForceUIMsgAsContentMsg|$wgForceUIMsgAsContentMsg}}</tvar>. Each message overridden in this way must be explicitly given, for example to let the sidebar link to versions given by the content language for the main page and the portal page add the following to
</translate>

<code>LocalSettings.php</code>
; code
<div style="margin-{{dir|{{pagelang}}|right|left}}: 2em;"><syntaxhighlight lang="javascript">
$wgForceUIMsgAsContentMsg = [ 'mainpage', 'portal-url' ];
</syntaxhighlight></div>

<translate>
===Add or remove toolbox sections (JavaScript)=== <!--T:33-->
</translate>
<translate><!--T:147--> The ''toolbox'' appears on the left under <tvar name=1>[[MediaWiki:Sidebar]]</tvar>.</translate>
<translate><!--T:148--> The toolbox is a dynamic element requiring programmatic methods such as skin extensions, PHP (see <tvar name=1><code>skins/MonoBook.php</code></tvar> and creating a new [[<tvar name=2>Special:MyLanguage/skins</tvar>|skin]]) or JavaScript.</translate>

<translate>
<!--T:149-->
The JavaScript solution uses User:{username}/common.js / [[MediaWiki:Common.js|MediaWiki:Common.js]], available for MediaWiki 1.9+.

<!--T:150-->
* Entire MediaWiki website: copy the script below into [[MediaWiki:Common.js|MediaWiki:Common.js]]</translate>
<translate>
<!--T:151-->
* One specific user: copy the script below into <tvar name=1>[[Special:MyPage/common.js]]</tvar> (or the JS page for the user's current [[<tvar name=2>Special:MyLanguage/Help:Skins</tvar>|skin]], such as <tvar name=3>[[Special:MyPage/monobook.js]]</tvar>).

<!--T:38-->
Now simply configure which link should appear in which section. You also can remove some links if you want to.
</translate>

====  code ==== 
<div style="margin-{{dir|{{pagelang}}|right|left}}: 2em;"><syntaxhighlight lang="javascript">
function ModifySidebar( action, section, name, link ) {
	try {
		switch ( section ) {
			case 'languages':
				var target = 'p-lang';
				break;
			case 'toolbox':
				var target = 'p-tb';
				break;
			case 'navigation':
				var target = 'p-navigation';
				break;
			default:
				var target = 'p-' + section;
				break;
		}

		if ( action == 'add' ) {
			var node = document.getElementById( target )
							   .getElementsByTagName( 'div' )[0]
							   .getElementsByTagName( 'ul' )[0];

			var aNode = document.createElement( 'a' );
			var liNode = document.createElement( 'li' );

			aNode.appendChild( document.createTextNode( name ) );
			aNode.setAttribute( 'href', link );
			liNode.appendChild( aNode );
			liNode.className = 'plainlinks';
			node.appendChild( liNode );
		}

		if ( action == 'remove' ) {
			var list = document.getElementById( target )
							   .getElementsByTagName( 'div' )[0]
							   .getElementsByTagName( 'ul' )[0];

			var listelements = list.getElementsByTagName( 'li' );

			for ( var i = 0; i < listelements.length; i++ ) {
				if (
					listelements[i].getElementsByTagName( 'a' )[0].innerHTML == name ||
					listelements[i].getElementsByTagName( 'a' )[0].href == link
				)
				{
					list.removeChild( listelements[i] );
				}
			}
		}


	} catch( e ) {
		// <translate nowrap><!--T:119--> let's just ignore what's happened</translate>
		return;
	}
}

function CustomizeModificationsOfSidebar() {
	// <translate nowrap><!--T:120--> adds [[Special:CategoryTree|Special:CategoryTree]] to toolbox</translate>
	ModifySidebar( 'add', 'toolbox', 'CategoryTree', 'https://en.wikipedia.org/wiki/Special:CategoryTree' );
	// <translate nowrap><!--T:121--> removes [[Special:Upload|Special:Upload]] from toolbox</translate>
	ModifySidebar( 'remove', 'toolbox', 'Upload file', 'https://en.wikipedia.org/wiki/Special:Upload' );
}

jQuery( CustomizeModificationsOfSidebar );
</syntaxhighlight></div>

; <translate><!--T:122--> Usage</translate>
: <code>function CustomizeModificationsOfSidebar()</code> <translate><!--T:104--> has to be customized for adding or removing links in specific sections:</translate>

: <code>ModifySidebar( "''action''", "''section''", "''name''", "''link''" );</code>

{| class="wikitable" style="margin-{{dir|{{pagelang}}|right|left}}:2em;" 
! <translate><!--T:123--> parameter</translate>
! <translate><!--T:124--> value</translate>
|-
| <code>action</code>
| ''add'' <translate><!--T:125--> to add a link</translate>; ''remove'' <translate><!--T:126--> to remove a link</translate>
|-
| <code>section</code>
| ''navigation'', ''toolbox'', ''languages'' <translate><!--T:127--> but also any other existing customized section; the given link will be added to or removed from this section</translate>
|-
| <code>name</code>
| <translate><!--T:128--> contains the text of the link</translate>
|-
| <code>link</code>
| <translate><!--T:129--> contains the URL of the link</translate>
|}

====  <translate><!--T:105--> Restricting modifications to specific usergroups</translate> ==== 

<div style="margin-{{dir|{{pagelang}}|right|left}}:2em;">
<translate><!--T:106--> If you want to restrict the modification of the links to a specific user group (e.g. ''bureaucrat''), change:</translate>
<syntaxhighlight lang="javascript">jQuery( CustomizeModificationsOfSidebar );</syntaxhighlight>
<translate><!--T:130--> to</translate>
<syntaxhighlight lang="javascript">
if ( mw.config.get( 'wgUserGroups', [] ).indexOf( 'bureaucrat' ) !== -1 ) {
	jQuery( CustomizeModificationsOfSidebar );
}
</syntaxhighlight>

<translate>
<!--T:53-->
For restricting the modifications to IPs instead of a specific user group, use
</translate>

<syntaxhighlight lang="javascript">
if ( mw.config.get( 'wgUserGroups', [] ).indexOf( 'user' ) === -1 ) {
	jQuery( CustomizeModificationsOfSidebar );
}
</syntaxhighlight>
</div>

<translate>
=== Add or remove toolbox sections (PHP) === <!--T:54-->

<!--T:55-->
You can add in your file LocalSettings.php the hook described [[<tvar name=1>Special:MyLanguage/User:Seb35/modifyToolbox</tvar>|on this page]]. With this, you can modify via <tvar name=2>[[MediaWiki:Sidebar]]</tvar> the links in the toolbox panel (remove some links, change their name) and add custom links (e.g. add the "Recent changes" link there instead of the navigation panel).

=== Make expanding/collapsing sidebar for all users (Monobook skin only) === <!--T:56-->

<!--T:57-->
If you use the Monobook skin and don't want to miss the expandable menu bar from e.g. Vector skin, paste the following code into [[MediaWiki:Monobook.js|MediaWiki:Monobook.js]] of your wiki.
</translate>

<syntaxhighlight lang="javascript">
/////////////////////////////////////////////////////////
// <translate nowrap><!--T:131--> Code snippet to make your sidebar items expandable.</translate> 
// <translate nowrap><!--T:132--> Use this code ONLY for the Monobook skin.</translate> 
/////////////////////////////////////////////////////////

$( document ).ready( function() {
	// <translate nowrap><!--T:133--> Set the default expanded items by their headline</translate>
	var defaultExpandItems = ['Navigation', 'Orga'];
	// <translate nowrap><!--T:134--> Set the basic-name for the cookies, which save the current state of expanding</translate>
	var expandCookieName = 'disdance_project_wiki_nav_expanded_';

var maxHeights = [];
	var expandeds = [];
	var labels = [];
	initNav();
});

function initNav() {
	$( '#p-logo' ).css({'position': 'relative', 'display': 'block'});
	$( '.generated-sidebar h5,#p-tb h5 ').each( function( i ) {
		var id = $( this ).parent().attr( 'id' );
		maxHeights[id] = $( this ).next( 'div' ).height();
		var str = $( this ).html();
		labels[id] = str;

if ( $.cookie( expandCookieName + id ) == 'false' ) {
			expandeds[id] = false;
			minimize( $( this ) );
		} else if ( $.cookie( expandCookieName + id ) == 'true' ) {
			expandeds[id] = true;
			maximize( $( this ) );
		} else if ( defaultExpandItems.indexOf( str ) == -1 ) {
			expandeds[id] = false;
			minimize( $( this ) );
		} else {
			expandeds[id] = true;
			maximize( $( this ) );
		}
		$( this ).css({'cursor': 'pointer'});
		$( this ).click( toggleNav );
	} );
}

function minimize( target ) {
	var id = $( target ).parent().attr( 'id' );
	// <translate nowrap><!--T:135--> You can change the expires parameter to save the cookie longer/shorter than 7 days like in this code</translate>
	$.cookie( expandCookieName + id, 'false', { expires: 7} );
	var str = labels[id] + '  ►';
	$( target ).next( 'div' ).animate({'height': '0px'});
	$( target ).html( str );
}

function maximize( target ) {
	var id = $( target ).parent().attr( 'id' );
	// <translate nowrap><!--T:136--> You can change the expires parameter to save the cookie longer/shorter than 7 days like in this code</translate>
	$.cookie( expandCookieName + id, 'true', { expires: 7} );
	var str = labels[id] + '  ▼';
	var newHeight = maxHeights[id];
	$( target ).next( 'div' ).animate({'height': newHeight + 'px'});
	$( target ).html( str );
}

function toggleNav( e ) {
	var id = $(e.target ).parent().attr( 'id' );
	expandeds[id] = !expandeds[id];
	if( expandeds[id] == true ) {
		maximize( e.target );
	} else {
		minimize( e.target );
	}
}

///////////////////////////////////////////////////////
///////////////////////////////////////////////////////
</syntaxhighlight>

<translate>
===Sidebar width in Monobook skin (CSS)=== <!--T:66-->
</translate>
<translate><!--T:67--> You can change the width of your sidebar by adding the following CSS rules to your [[MediaWiki:Monobook.css|MediaWiki:Monobook.css]]</translate>
<!-- This intentionally says Monobook.css not Common.css -->;
<translate><!--T:137--> note that this is an '''article''', <u>not</u> a file. This changes the width to 15em, the actions position and portlet width should be an em or so less, so I've set them to 14em in this example.</translate>

<syntaxhighlight lang="css">
/* <translate nowrap><!--T:141--> increase sidebar width</translate> */
#column-content { margin-left: -15em; }
#column-content #content { margin-left: 15em; }
#p-logo a, #p-logo a:hover { width: 15em; }
#p-cactions { left: 14.5em; }
.portlet { width: 14em; }
#column-content { margin-left: -14em; }
#content.mw-body { margin-left: 14em; }
</syntaxhighlight>

<translate>
===Change sidebar content when logged in (PHP)=== <!--T:71-->

<!--T:146-->
Install and configure the <tvar name=1>{{ll|Extension:DynamicSidebar|DynamicSidebar}}</tvar> extension.

===Parser functions in sidebar=== <!--T:75-->

<!--T:76-->
Although it is not exactly recommended, the sidebar does support parser functions (such as <tvar name=1>{{ll|Extension:ParserFunctions|ParserFunctions}}</tvar>), provided the <tvar name=2><code>**</code></tvar> is outside the parser function, and the parser function does not span multiple lines. For example:
</translate>

<pre>
*Heading
**{{#ifeq:{{NAMESPACE}}|User|Page-to-link-to{{!}}text-to-show-on-user-page}}
**{{#ifeq:{{NAMESPACE}}|Talk|Another-Page-to-link-to{{!}}text-to-show-on-talk-page}}
</pre>

<translate><!--T:108--> works. However the following would '''not''' work since the parser function spans multiple lines:</translate>
<pre>
*Heading
{{#ifeq:1|1|
**foo{{!}}
bar
|
**baz{{!}}fred
}}</pre>

<translate>
==Troubleshooting== <!--T:80-->

===Changes not showing up=== <!--T:81-->
</translate>
<translate><!--T:82--> MediaWiki aggressively caches content if possible, which often causes the navigation bar to persist after changes.</translate>
<translate><!--T:143--> [[<tvar name=1>Special:MyLanguage/Manual:Purge</tvar>|Purging the cache]] of affected pages should correct the situation.</translate>
<translate><!--T:144--> To perform a mass-purge of all caches at once, [<tvar name=url>http://www.freebsd.org/cgi/man.cgi?query=touch</tvar> touch] the <tvar name=1><code>'''LocalSettings.php'''</code></tvar> file or [<tvar name=url2>https://dev.mysql.com/doc/refman/8.0/en/truncate-table.html</tvar> truncate] the <tvar name=2><code>'''objectcache'''</code></tvar> table in your database (you may have to do both).</translate>

<translate><!--T:83--> You also need to have <tvar name=1>{{ll|Manual:$wgUseDatabaseMessages|$wgUseDatabaseMessages}}</tvar> set to <code>true</code>.</translate>
<translate><!--T:152--> Also, if your links don't have a <tvar name=1><code>|</code></tvar> in them, they will not show up because of this line of code in <tvar name=2>Skin.php</tvar>:</translate>
<code>if ( strpos( $line, '|' ) !== false ) {</code>

<translate>
<!--T:84-->
If you are a user or average wiki admin, you will not be able to do the advanced stuff above to get changes to show up. If purging does not work either, you can sometimes still see CSS changes right away in preview (especially when changing your personal CSS). For example; changing the sidebar width, padding, or margins. Changes can take awhile to show up after saving though. If nothing shows up after awhile you may need to contact the overall wiki, or wiki farm, sysop.

===Lowercase link labels=== <!--T:85-->

<!--T:86-->
If your links are not being capitalized as intended, try adding spaces around the bar character; for example:
<tvar name=code><pre>** http://www.example.com/download.php?file=44555 | Download</pre></tvar>

===Sections disappear or show unexpected content=== <!--T:87-->

<!--T:88-->
If a section does not display or displays unexpected content, check that the header text isn't the name of an interface message by searching [[<tvar name=spec-am>Special:AllMessages</tvar>|Special:AllMessages]]. If it is, use a different header text, or create a new interface message and use it.

<!--T:89-->
For example, if you want to use "<tvar name=txt>Sidebar</tvar>" as header text, create the interface message "<tvar name=msg>MediaWiki:Sidebar-header</tvar>" containing only "<tvar name=msg-txt>Sidebar</tvar>". Then, use <tvar name=code><code><nowiki>* sidebar-header</nowiki></code></tvar> as header.

<!--T:90-->
Sections are not displayed if there are no links of the form {{<tvar name=1>tmpl|0=<code>** $1 {{!}} $2</code></tvar>|target|link text}} (e.g. when the target was forgotten).

===Broken links after updating [[<tvar name=spec-ver>Special:Version</tvar>|Special:Version]]=== <!--T:91-->

<!--T:92-->
This will happen e.g., each time there are newer translations for your site language's sidebar items.
One could add new redirect pages each time, but a better solution would be to use one's own sidebar item names instead of trying to keep track of the current MediaWiki translations.

==See also== <!--T:95-->
</translate>

* {{ll|Sidebar}}
* {{ll|Extension:SideBarMenu}}
* {{ll|Quickbar}}
* {{ll|Manual:Interface/Sidebar/Hacks}} - Unsupported PHP modifying hacks that used to be on this page
* {{ll|Manual:$wgEnableSidebarCache}}
* {{ll|Category:Menu extensions}}
* {{ll|Manual:Remove Tabs}} - remove MediaWiki tabs

==References==
<references/>

[[Category:MediaWiki administration{{#translation:}}]]