Instalação do MediaWiki em sites pessoais em WebHostings

De Eriberto Wiki
Ir para: navegação, pesquisa
Twitter.png

by (C) João Eriberto Mota Filho <eriberto (a) eriberto pro br>

Artigo criado em: 28 de março de 2007.

Última atualização: veja o rodapé desta página.

Tiny URL ou bit.ly: {{{2}}}



O MediaWiki é, com certeza, o sistema de Wiki mais famoso do mundo. Foi criado para a Wikipedia e possui diversas funcionalidades interessantes.

Este tutorial irá mostrar como proceder para instalar o MediaWiki no seu site (hospedado por um WebHosting). As orientações aqui contidas foram criadas com base na versão 1.9.3 e, atualmente, estão adaptadas para a versão 1.13.3.


Requisitos no WebHosting

  • MySQL
  • PHP5
  • Apache
  • CPanel


Instalação do MediaWiki

  • Descompacte o tarball, utilizando o comando tar.
  • Exclua os seguintes arquivos e diretórios:
bin
COPYING
CREDITS
docs
FAQ
HISTORY
INSTALL
Makefile
README
RELEASE-NOTES
serialized
t
tests
UPGRADE
  • Ainda, dentro do diretório languages/messages, DEIXE somente os seguintes arquivos:
MessagesEn.php
MessagesPt_br.php
Exclamacao36.png Uma forma simples de remover os arquivos excedentes dentro de languages/messages é com o comando # ls | egrep -v '(En.php|Pt_br.php)' | xargs rm -rf. Lembre-se: você deverá estar dentro do diretório para executar tal comando.
  • Com o auxílio de um cliente FTP (no GNU/Linux sugiro o gFTP), copie todo o diretório para dentro do seu website.
  • Uma vez feito o upload, se for o caso, renomeie o diretório (já dentro do seu site) para algo mais amigável. No meu caso, renomeei de mediawiki-1.13.3 para wiki.



Criação do banco de dados a ser utilizado

  • Entre no CPanel (diponibilizado pelo seu WebHosting) e escolha a opção que permite configurar o banco de dados (no meu caso foi Banco de dados MySQL).
  • Crie um banco de dados para o Wiki. Exemplo: meuwiki.
  • Crie um usuário para acessar o banco. Exemplo: meuwikiuser (utilize uma boa senha).
  • Adicione o usuário ao banco.
Exclamacao36.png É importante ressaltar que, muitas vezes, o CPanel irá adicionar um prefixo ao nome do banco e ao nome do usuário do banco. Geralmente, esse prefixo, será o seu login no WebHosting.



Configuração inicial do MediaWiki

Para configurar o MediaWiki, em um browser (Firefox ou Iceweasel, por exemplo), digite:

http://endereço_do_seu_site/wiki
Exclamacao36.png Lembre-se de que /wiki é o nome do diretório renomeado por FTP.

Se tudo estiver certo, será mostrada uma tela de configuração do MediaWiki. Configure o MediaWiki de acordo com as instruções. Utilize o banco, o usuário do banco e as senhas corretas, de acordo com os dados inseridos via CPanel. Não será necessário o uso de root (Superuser account), uma vez que o banco já foi criado manualmente no CPanel. O campo Database table prefix também poderá ficar em branco.

Depois de tudo pronto, clique em Install MediaWiki!. Será gerado o arquivo LocalSettings.php, dentro do diretório /wiki/config (dentro do seu site). Por FTP, copie esse arquivo para um diretório local no seu computador. A seguir, copie o mesmo arquivo do seu computador para o diretório /wiki (no seu site). No browser, digite:

http://endereço_do_seu_site/wiki

Deverá ser mostrado o Wiki, já funcionando. Confira se tudo está ok. Na página principal, clique em editar. NÃO EDITE NADA AINDA. Apenas verifique se você conseguiu entrar no ambiente de edição.

Configuração básica do serviço

  • Clique em entrar (acima e à direita) e logue como SysOp do Wiki (você configurou o usuário e a senha de SysOp anteriormente). A seguir, digite a URL:
http://localhost/wiki/index.php?title=MediaWiki:Sidebar&action=edit
  • Elimine as entradas indesejadas para o menu que aparece na esquerda. Depois, salve e saia.
  • Clique em sair (acima e à direita). A seguir, clique em entrar. Na tela que abrirá, clique em Criar uma conta. Crie uma conta para você poder inserir conteúdo no Wiki.


Segurança e restrições de acesso

Medidas iniciais de segurança

  • Incialmente, altere a permissão do arquivo LocalSettings.php para 600 com o comando:
# chmod 600 LocalSettings.php
  • Terminada a configuração, faça um upload por FTP do LocalSettings.php, para repôr tal arquivo dentro do diretório /wiki do seu site. Não esqueça de verificar as permissões do arquivo já dentro do site (a maioria dos clientes FTP possibilita isso). A permissão correta deverá ser 600.
  • Ainda, como medida de segurança, uma vez verificado o correto funcionamento do Wiki, remova o diretório config de dentro do site (em /wiki), para evitar que outras pessoas tentem reconfigurar o Wiki remotamente.
  • Por fim, teste a segurança utilizando a seguinte URL:
http://endereço_do_seu_site/wiki/LocalSettings.php

O resultado deverá ser algo como:

This file is part of MediaWiki and is not a valid entry point


Outras configurações de segurança

A partir de agora, faremos alterações dentro do arquivo LocalSettings.php (há uma cópia dentro da sua máquina local, uma vez que fizemos download do mesmo por FTP).

  • Para evitar que usuários anônimos possam modificar o conteúdo do seu Wiki, edite o LocalSettings.php e insira, no final, a linha:
$wgGroupPermissions['*']['edit'] = false;
  • Para evitar que usuários anônimos possam ler o conteúdo, no mesmo arquivo, insira:
$wgGroupPermissions['*']['read'] = false;
  • Para evitar que qualquer usuário, além de você, edite o Wiki, crie a sua conta normalmente (clique em entrar - em cima e à direita). A seguir, insira as seguintes linhas no fim do arquivo LocalSettings.php:
$wgGroupPermissions['*']['edit'] = false;
$wgGroupPermissions['*']['createaccount'] = false;
  • Com a alteração anterior, será necessária uma conta para editar o conteúdo do wiki. No entanto, ninguém conseguirá criar uma nova conta e, assim, apenas você terá acesso, pois já possuirá uma conta.


Alterando o logotipo

O logotipo que aparece no canto superior esquerdo poderá ser alterado. Para isso, no arquivo LocalSettings.php, insira ou altere o valor da linha $wgLogo. Exemplo:

$wgLogo = "/wiki/eriberto.png";

Lembre-se de fazer upload do novo arquivo LocalSettings.php e da imagem referente ao logotipo.

Exclamacao36.png A imagem deverá ter, no máximo, 155x155 pixels.



Alterando o rodapé

Para alterar o rodapé do Wiki (retirando o Disclaimer, por exemplo), edite o arquivo skins/MonoBook.php e remova as opções indesejadas constantes na linha $footerlinks. As opções existentes nesta linha podem ser vistas no FAQ da MediaWiki (veja How do I change the footer?).

Alterando o fuso horário

Para que o Wiki utilize o mesmo fuso horário do usuário no momento de uma edição (horário Brasileiro), acresça no final do arquivo LocalSettings.php a seguinte linha:

$wgLocalTZoffset = -180;

Na linha anterior, estamos retirando 180 minutos (3 horas) do horário de Greenwich.

Alterando as mensagens de tela e menus

É possível alterar as mensagens que aparecem na tela e os nomes que aparecem nos menus. Para isso, edite o arquivo languages/messages/MessagesPt_br.php. Normalmente, encontraremos alguns erros de tradução que poderão ser corrigidos. Eu, por exemplo, encontrei, na versão 1.9.3, a expressão "Artigos Relacionado" no menu da esquerda (faltou a concordância nominal).

Permitindo o upload de arquivos e imagens

Para permitir que as pessoas que editam o wiki façam o upload de arquivos, altere o arquivo LocalSettings.php e altere a linha:

$wgEnableUploads = false;

para

$wgEnableUploads = true;


Instalando o MediaWiki no SourceForge

Por favor, veja este link: http://www.mediawiki.org/wiki/Manual:Running_MediaWiki_on_Sourceforge.net.

Obtendo ajuda via IRC

O canal de chat do MediaWiki é muito movimentado e os participantes procuram ajudar ao máximo. Para obter ajuda no IRC, conecte-se ao servidor irc.freenode.net, porta 6667, canal #mediawiki. A conversação deverá ser em inglês.

Veja também



Links externos

Configuração do Wiki

Utilização do Wiki

Outros wikis interessantes

  • Tiddly Wiki (Um wiki em apenas um arquivo em JavaScript)


Comentários, sugestões e controle de acessos

Por favor, deixe os seus comentários e sugestões sobre este artigo no meu Blog Técnico. Para isto, clique aqui.




Consulte também o contador abaixo, iniciado em 28 mar. 07, além do gráfico acima.