Wikimore

Skins:

Esta página explica como administradores podem configurar os temas de uma wiki.

Esta documentação aplica-se ao MediaWiki 1.31+.

Para usar temas, consulte Help:Skins , onde são detalhadas maiores informações sobre temas.

Para desenvolvedores que desejam criar novos temas ou editar temas existentes, consulte Manual:How to make a MediaWiki skin para informações técnicas.

Baixando temas

O download do tarball do MediaWiki vem integrado com vários temas. Veja a lista em Extensões e temas inclusos#Temas.

Contudo, se você baixou o MediaWiki a partir do Git ou deseja instalar temas adicionais, será necessário baixar o código para esses temas separadamente.

Vários temas do MediaWiki estão hospedados no repositório Git da Wikimedia (veja a listagem completa de temas no repositório). É possível baixar os tarballs dos temas a partir do distribuidor de temas.

Para baixar um dos temas deste grupo via Git, faça uma chamada como a seguinte:

git clone https://gerrit.wikimedia.org/r/mediawiki/skins/[nome do tema]

P. ex., para baixar o tema padrão Vector, execute o seguinte a partir do subdiretório skins/ da sua pasta de instalação do MediaWiki:

git clone https://gerrit.wikimedia.org/r/mediawiki/skins/Vector

Faça o checkout de uma release específica do tema. Mude para o novo diretório e execute:

git checkout REL1_43

(substitua REL1_43 por outra release branch ou tag)

Ativando temas

Para qualquer tema contido em seu diretório /skins que você deseje usar, será necessário ativá-lo em seu arquivo LocalSettings.php . Por exemplo, para permitir o Vector, adicione o seguinte. Caso hajam múltiplos temas a serem ativados, cada um deve sê-lo através de uma declaração separada:

wfLoadSkin( 'Vector' );

(Isso é equivalente a ativar uma extensão, com a diferença de ser em um diretório diferente.)

Etapas adicionais podem ser necessárias, dependendo da escolha do tema. Instruções mais detalhas de instalação estão disponíveis em cada página de tema no mediawiki.org; por exemplo, para o Vector, veja Tema:Vector#Instalação. O mesmo vale para a instalação de outros temas.

Definindo o tema padrão de uma wiki

Um tema padrão para novos usuários de uma wiki pode ser definido através da variável $wgDefaultSkin no LocalSettings.php , especificando o nome do tema em letras minúsculas, tal como consta no arquivo do tema. Os usuários continuarão podendo alternar temas em suas preferências, a menos que os outros temas sejam desinstalados ou suprimidos. Há também a possibilidade de desativar essa preferência (veja abaixo). Vamos a um exemplo:

$wgDefaultSkin = 'vector';

Modificar esse valor em uma wiki já existente fará com que todos os usuários passem para esse tema automaticamente. There is a maintenance script to change users' preferences (userOptions.php ), but you will most likely not need to use it.

Caso prefira deixar esse valor intacto, o Vector continuará sendo o tema padrão.

Desinstalando temas

Para desinstalar um tema, remova a linha wfLoadSkin de seu arquivo LocalSettings.php . You may remove the skin files from the skins/ directory afterwards.

Caso hajam usuários utilizando o tema que acabou de ser desinstalado, o MediaWiki alternará para o tema padrão da wiki automaticamente.

Suprimindo temas sem desinstalar

O administrador tem o poder de limitar as escolhas de temas oferecidas nas preferências do usuário para aquele website através da listagem de temas a serem removidos no arranjo $wgSkipSkins . Isso pode ser útil para testar um novo tema sem que os outros usuários possam saber. Para fazer isso, insira algo como o seguinte no LocalSettings.php :

// To remove various skins from the User Preferences choices
$wgSkipSkins = [ "monobook", "timeless" ];

Você poderá obter uma previsão do tema através do parâmetro do URL useskin .

Modificações no CSS do website inteiro

MediaWiki allows administrators to specify site-wide CSS rules to be added to every page rendered. These rules can be added by editing the page MediaWiki:Common.css on your wiki, if $wgUseSiteCss is set to true. In addition to a global stylesheet, one can also specify CSS rules to be used only in certain skins (see Manual:Interface/Stylesheets).

Modificações no CSS do usuário

Users can also specify their own CSS rules by creating the page "User:Username/common.css". The CSS on this page is then applied to whatever skin the user is using. If the website is changed to a different default skin, the user's custom CSS will continue to work just as before. This feature can be enabled by setting $wgAllowUserCss to true in LocalSettings.php . A user can also apply CSS to a specific skin by creating the page "User:Username/skinname.css". If a user uses the MonoBook skin for example, they would edit the page Special:MyPage/monobook.css.

Desabilitar a opção dos usuários do website escolherem temas nas preferências do usuário

Versão MediaWiki:

≥ 1.16

O administrador de sistema pode remover completamente a opção “Tema”, de forma que não apareça uma única vez nas preferências do usuário. Isso pode fazer sentido se seu website utiliza um tema personalizado e ele não ficaria bem em nenhum outro tema.

Para fazer isso, adicione uma nova linha contendo o seguinte código ao LocalSettings.php. Isso removerá a opção “Tema” das preferências e a possibilidade de usar o parâmetro useskin no URL.

$wgHiddenPrefs[] = 'skin';