Manual:Configuração de temas
Esta página explica como administradores podem configurar os temas (skins) 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:Como fazer um tema do MediaWiki para informações técnicas.
Baixar 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_44
(substitua REL1_44 por outra release branch ou tag)
Ativar 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.
Definir 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.
Há um script de manutenção para alterar as preferências dos usuários (userOptions.php), mas você provavelmente não precisará utilizá-lo.
Caso prefira deixar esse valor intacto, o Vector continuará sendo o tema padrão.
Desinstalar temas
Para desinstalar um tema, remova a linha wfLoadSkin de seu arquivo LocalSettings.php.
Depois, você poderá remover os arquivos de tema do diretório skins/.
Caso hajam usuários utilizando o tema que acabou de ser desinstalado, o MediaWiki alternará para o tema padrão da wiki automaticamente.
Suprimir 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
O MediaWiki permite que os administradores especifiquem regras CSS aplicáveis ao website inteiro, a serem adicionadas a cada página renderizada.
Essas regras podem ser adicionadas editando a página MediaWiki:Common.css em sua wiki, se $wgUseSiteCss estiver definida como verdadeiro (true).
Além de uma folha de estilo global, também é possível especificar regras CSS a serem usadas somente em determinados temas (veja Manual:Interface/Stylesheets).
Modificações no CSS do usuário
Os usuários também podem especificar suas próprias regras de CSS criando a página “Usuário:Nome de usuário/common.css”.
O CSS nessa página é então aplicado a qualquer tema que o usuário esteja usando.
Se o website for alterado para um tema padrão diferente, o CSS personalizado do usuário continuará a funcionar como antes.
Esse recurso pode ser ativado através da definição $wgAllowUserCss no LocalSettings.php.
O usuário também pode aplicar CSS a um tema específico criando a página “Usuário:Nome de usuário/nomedotema.css”.
A título de exemplo, se o usuário utiliza o tema MonoBook, essa ação seria realizada na página Special:MyPage/monobook.css.
Desabilitar a opção dos usuários do website escolherem temas nas preferências do usuário
| Versão do 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';