Manual:Interface/Sidebar/pt


 * See also: Manual:Remove Tabs

MediaWiki:Sidebar define a barra de navegação, a qual provê enlaces à maioria dos lugares na wiki e fornece aos administradores do lugar um lugar para adicionar uma colecção constante de enlaces. Por exemplo, a maioria das wikis enlaçarão à página de discussão de sua comunidade e a algumas ferramentas úteis. The navigation bar which provides links to the most important locations in the wiki and supplies site administrators with a place to add an important collection of links. For instance, most wikis will link to their community discussion page and some useful tool pages.

Os skins Monobook e Vetor colocam a barra de navegação acima à esquerda (top-right for right-to-left languages) junto à barra de busca e à caixa de ferramentas, mas a localização pode ser diferente em outros skins. This sidebar is not shown to users of the Mobile site (i.e. the version of the site produced by /  - use the  hook for that).



Personalizar varra-a lateral
Para personalizar a MediaWiki:Sidebar numa wiki, você primeiro precisa estar registado com um utente que tenha a permissão editinterface - Isto está habilitado por defeito para os administradores.

You can access MediaWiki:Sidebar by either:


 * Going to http://yourdomain/wiki/index.php?title=MediaWiki:Sidebar&action=edit in your browser.
 * Typing MediaWiki:Sidebar in search bar, and validating with Enter.
 * From Special:AllMessages, searching for "side".

A seguir mostra-se um código de exemplo para uma varra lateral:


 * navigation
 * mainpage|Accueil
 * Special:RecentChanges|Recent changes
 * new heading
 * portal-url|Forums
 * https://www.mediawiki.org|MediaWiki home

This example will result in the following sidebar:

Splitting the navigation bar into new sections
A barra de navegação pode estar dividida em secções, a cada uma com seu próprio encabeçado. This is done by adding one asterisk.

O encabeçado para a cada secção é tomado desde a lista de elementos do primeiro nível ("navigation" e "new heading" no exemplo de acima). Se este texto corresponde ao nome de uma mensagem da interface (Uma página existente nesse título na MediaWiki namespace), então o texto dessa página é usado como uma etiqueta; caso contrário, o título do encabeçado utiliza-se tal qual. Please note the  magic word does not work since it is useless: MediaWiki automatically looks for a translation to display before to fallback to the default message.

In the example above,  and   are section headings.

Creating links in the sidebar
Links are created with 2 asterisks (called Second-level list elements). For example:

** target | link text


 * objectivo
 * O enlace objectivo pode ser o nome de uma mensagem de interface (uma página no MediaWiki namespace) ou uma página wiki, ou um enlace externo. Em qualquer caso, o link pode ser interno, interwiki ou externo.
 * Do the following to determine the target:
 * Chamar o texto objectivo.
 * Se há um existente ou uma mensagem de interface por defeito com esse nome, use o conteúdo dessa mensagem em vez do texto objectivo.
 * Se a saída do passo anterior é uma URL valida (começando com http:// ou outro URL protocol), o enlace apontará a essa URL.
 * se não, tratar-se-á como o enlace objectivo de um wikilink (enlaçando a esse nome de página ou interwiki).
 * Em caso que termine enlaçando a '-', toda a entrada é removida da varra lateral (isso é útil para remover uma entrada em todas as linguagens ao mudar a mensagem que tem o enlace).

Exemplos:
 * " " usa o texto de MediaWiki:Portal-url (o qual contém "")
 * " " links to https://www.mediawiki.org since this is a valid URL.
 * " " links to Special:RecentChanges, since there is no interface message of that name and that is not a valid URL.
 * " " links to w:Foo for the same reason.


 * enlace de texto
 * O enlace de texto pode ser o mesmo de uma mensagem de interface (página no the MediaWiki namespace) ou texto plano.
 * Se o enlace de texto é o nome de uma mensagem de interface existente ou por defeito, o conteúdo dessa mensagem será usada. Mediawiki verificará as versões localizadas; por exemplo, se a linguagem actual é fr (Frances) e o enlace de texto é a mensagem de interface "fórum", este verificará "fórum/fr" dantes de usar "fórum".
 * Em qualquer caso, o enlace de texto é usado como destino.
 * Note que o enlace de texto não é opcional como os enlaces numa wiki normal. Se falta o enlace de texto, o elemento ignora-se.


 * The link text can be the name of an interface message (page in the MediaWiki namespace) or plain text.


 * 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".


 * Otherwise, the link text is used as the target as-is.


 * Notice that the link text is not optional as in normal wiki links. If the link text is missing, the item is ignored.

Exemplos:
 * uses MediaWiki:Mainpage (which contains "").
 * uses "Recent changes", since there is no interface message of that name.



Ordem dos elementos
Some skins allow customizing the order of some special elements, like the search bar, toolbox, and languages. That can be done by adding the special keywords SEARCH, TOOLBOX and LANGUAGES respectively, to MediaWiki:Sidebar using the heading syntax.

However, some skins like MonoBook 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. In that case, to move the search element at the top, the workaround is to define an empty leading section. For example:


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

Note that some skins may display the first section differently, or place some element between the first and the second section (if any).

Tooltips and Accesskey
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.

If you add an item to the sidebar, it will have no "tooltip". But you can create a tooltip by doing the following:


 * create a wiki page named "MediaWiki:Tooltip-n-&lt;id of the item>"
 * and put the tooltip in that page.

An access key or accesskey allows a computer user to immediately jump to a specific part of a web page via the keyboard.

Accesskeys can also be created by doing the following:


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

Example:


 * uses MediaWiki:Tooltip-n-mainpage-description and MediaWiki:Accesskey-n-mainpage-description.

Traduções
Você pode traduzir as correntes, a qual você usa, editando as páginas de acordo ao namespace na MediaWiki.

Exemplo: A corrente, a qual substituirá o elemento chamado "mainpage", é tomado de MediaWiki:Mainpage. Para configurar/mudar este texto para os utentes, quem despliegan seu wiki em Alemão, pode colocar o texto de acordo à página MediaWiki:Mainpage/de.

Dessa maneira você pode facilmente traduzir esses textos através da interface da MediaWiki.

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 in order to show a modified sidebar to all users, who have not changed their language setting and to all anonymous users.

For more advanced translation, see.

Advanced customization
The sidebar can be fully customized by implementing JavaScript or Cascading Style Sheets, or by editing the PHP files directly. Before using these methods, note that:


 * JavaScript is fragile: it will not work for users with JavaScript disabled, and scripts frequently fail in different browsers or skins.
 * 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
To completely remove the sidebar and logo:

Blank the MediaWiki:Sidebar page and save.

Then add:

This moves the main text of your wiki to the left.

Completely remove the sidebar, tabs and search bar

 * See also: Manual:Remove Tabs

Deletes the logo, and the entire sidebar:


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

Deletes the search bar:


 * 1) p-search { display:none; }

Deletes the talk tab:


 * 1) ca-talk { display:none!important; }

Deletes the Page tab:


 * 1) ca-nstab-main { display:none!important; }

Force UI-messages to follow content
Some pages should sometimes follow the content language, especially for multilingual sites. This can be controlled with the setting. 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


 * code

Add or remove toolbox sections (JavaScript)
The toolbox appears on the left under MediaWiki:Sidebar. The toolbox is a dynamic element requiring programmatic methods such as skin extensions, PHP (see  and creating a new skin) or JavaScript.

The JavaScript solution uses User:{username}/common.js / MediaWiki:Common.js, available for MediaWiki 1.9+.


 * Entire MediaWiki website: copy the script below into MediaWiki:Common.js
 * One specific user: copy the script below into Special:MyPage/common.js (or the JS page for the user's current skin, such as Special:MyPage/monobook.js).

Now simply configure which link should appear in which section. You also can remove some links if you want to.

code



 * Usage
 * has to be customized for adding or removing links in specific sections:



Restricting modifications to specific usergroups
 If you want to restrict the modification of the links to a specific user group (e.g. bureaucrat), change: to

For restricting the modifications to IPs instead of a specific user group, use

Add or remove toolbox sections (PHP)
You can add in your file LocalSettings.php the hook described on this page. With this, you can modify via MediaWiki:Sidebar 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)
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 of your wiki.

Sidebar width in Monobook skin (CSS)
You can change the width of your sidebar by adding the following CSS rules to your MediaWiki:Monobook.css note that this is an article, not 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.

Change sidebar content when logged in (PHP)
Install and configure the extension.

Parser functions in sidebar
Although it is not exactly recommended, the sidebar does support parser functions (such as ), provided the  is outside the parser function, and the parser function does not span multiple lines. For example:


 * Heading

works. However the following would not work since the parser function spans multiple lines:
 * Heading

Changes not showing up
MediaWiki aggressively caches content if possible, which often causes the navigation bar to persist after changes. Purging the cache of affected pages should correct the situation. To perform a mass-purge of all caches at once, touch the  file or truncate the   table in your database (you may have to do both).

You also need to have set to. Also, if your links don't have a  in them, they will not show up because of this line of code in Skin.php:

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
If your links are not being capitalized as intended, try adding spaces around the bar character; for example: ** http://www.example.com/download.php?file=44555 | Download

Sections disappear or show unexpected content
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 Special:AllMessages. If it is, use a different header text, or create a new interface message and use it.

For example, if you want to use "Sidebar" as header text, create the interface message "MediaWiki:Sidebar-header" containing only "Sidebar". Then, use  as header.

Sections are not displayed if there are no links of the form (e.g. when the target was forgotten).

Broken links after updating Special:Version
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.



Ver também

 * - Unsupported PHP modifying hacks that used to be on this page
 * - remove MediaWiki tabs
 * - Unsupported PHP modifying hacks that used to be on this page
 * - remove MediaWiki tabs
 * - remove MediaWiki tabs
 * - remove MediaWiki tabs
 * - remove MediaWiki tabs