Treinamento da ferramenta MediaWiki

Treinamento da ferramenta MediaWiki Treinamento de Instalação, configuração e customização do MediaWiki Viçosa, 18 de Junho de 2009

Pré-requisitos Servidor Web com suporte a PHP Servidor de banco de dados MySQL Pacote com arquivos do MediaWiki

Pré-requisitos Servidor Web com suporte a PHP Servidor de banco de dados MySQL Pacote com arquivos do MediaWiki EasyPHP Não é necessário baixar pacote para tradução do wiki para a lingua portuguesa, mas... (sempre tem um mas...) a instalação é feita em uma interface em inglês.

Procedimento default começa... Extraia o arquivo do MediaWiki. Observe que o pacote disponibilizado está em formato.tar.gz. Dependendo do (des)compactador de arquivos instalado, será necessário descompactar duas vezes. O nome da pasta com o wiki provavelmente será mediawiki-versao. Renomeie para um nome mais apresentável. O cliente não quer saber que está usando o MediaWiki e muito menos qual versão. Ele quer o wiki funcionando.

Procedimento default... Entre em http://localhost/wiki/ e inicie o processo de instalação. Esqueça o Next. Next.. Next...! Toda a configuração é feita nessa página. Language: pt-br - Português do Brasil Em Database config, além de requerer o nome do banco de dados, o MediaWiki obriga a inserção de um usuário e senha para conexão com o banco de dados... Vamos abrir um parênteses, então..

Procedimento default... Entre em http://localhost/wiki/ e inicie o processo de instalação. Esqueça o Next. Next.. Next...! Toda a configuração é feita nessa página. Language: pt-br - Português do Brasil Em Database config, além de requerer o nome do banco de dados, o MediaWiki obriga a inserção de um usuário e senha para conexão com o banco de dados... Vamos abrir um parênteses, então.. (

Sobre o banco de dados Nada nos impede de utilizar um bd já em uso por outras ferramentas (fórum, site ou outros) em conjunto com o MediaWiki. Basta definir em Database table prefix um prefixo para as tabelas do MediaWiki (para evitar conflitos..) Para criar um banco de dados: Abra o painel de administração do EasyPHP e, em seguida, o phpmyadmin (MySQL Administrar). Crie o banco de dados e preencha o campo Database name com o nome escolhido.

Criando usuário para o MySQL Clique na logo do phpmyadmin (ou na casa abaixo dela) para voltar à tela de administração. No topo da página, clique em Privilégios. Você pode optar por modificar a senha do usuário root ou criar um novo usuário. Fico pela 2ª opção... Clique em Adicionar novo usuário. Nome: um nome de usuário qualquer Servidor: Local (para fins de maior segurança) Senha: (preciso explicar?)

Criando usuário para o MySQL Quanto aos privilégios... Marcar todos resolve nosso problema. É importante ressaltar que todos esses privilégios estão concedidos pois você é o dono do servidor. Ao instalar fórum, wiki, etc para um cliente, com certeza terá muito menos privilégios, além de serem restritos a determinados bancos de dados. Cadê o botão Criar??? O botão Executar deve ajudar no que deseja...

) default... Parênteses fechado. Há diversas opções na configuração do MediaWiki, mas não é objetivo deste curso abordá-las. Para mais informações sobre o MediaWiki e essas opções, o site http://mediawiki.org provavelmente lhe será útil. Após informados esses e outros dados necessários, clique em Install MediaWiki!

Para que Next. Next..? Um já foi o suficiente (ou mais.. se não completou todos os campos ou encontrou um erro...). Mas... (num disse que sempre tinha um mas?) Hora de botar a mão na massa...

LocalSettings.php Esse arquivo encontra-se na pasta config. Mova-o para a pasta raiz do wiki. A maioria das customizações são realizadas a partir desse arquivo. Veremos uma dessas daqui há alguns slides.

Wiki instalado! Vamos aos testes! Login e edição de páginas. Clicar nos links para o próprio wiki e verificar se funcionam. Fazer upload de imagens.

Wiki instalado! Vamos aos testes! Login e edição de páginas. Clicar nos links para o próprio wiki e verificar se funcionam. Fazer upload de imagens. Uai... tem essa opção aqui não, sô...

Primeira customização: Permitindo o upload de imagens Antes de prosseguir, garanta que todos tem permissão de escrita à pasta images dentro do wiki Basta definir permissão 777 ou -rwxrwxrwx No momento isso provavelmente não será necessário, mas ao instalar um wiki para o cliente deve-se atentar para essas permissões. Abra o arquivo LocalSettings.php e defina a variável $wgenableuploads como true.

Primeira customização: Permitindo o upload de imagens Para maior segurança, dentro da pasta images, crie as pastas archive, thumb e temp, definindo permissão de escrita para as 3. No arquivo LocalSettings.php, descomente a linha #$wghasheduploaddirectory = false;

Segunda customização: Logo e ícone do cliente Pois então... no arquivo LocalSettings.php, defina duas variáveis: $wglogo e $wgfavicon. $wglogo = $wgscriptpath/enderecodaimagem.png ; $wgfavicon = $wgscriptpath/enderecodoicone.ico ; Dimensões da imagem: 155x135 É interessante que a imagem seja em png com fundo transparente, para evitar quebras na região da logo. $wgscriptpath Essa variável guarda o endereço do wiki a partir da raiz do site

Terceira customização: Permitindo upload de PDF, DOC e outros Abra aquele arquivo e adicione: ## Permitindo upload de arquivos PDF, DOC, DOCX, ODT, ## XLS, XLSX, etc.. $wgstrictfileextensions = true; $wgfileextensions = array_merge($wgfileextensions, array( 'pdf', 'doc', 'docx', 'odt', 'xls', 'xlsx', 'ods', 'ppt', 'pptx', 'pps', 'ppsx', 'odp', 'zip', 'rar')); $wguploadsizewarning = false; $wgmaxuploadsize = 1024*1024*1000; // 1Gb upload máximo $wgcheckfileextensions = true; $wgverifymimetype = false; // Desabilita detecção de mime type

Quarta customização: Bloqueio para visitantes Sim... é o mesmo arquivo.. Três configurações básicas: Bloqueando a leitura por visitantes: $wggrouppermissions['*']['read'] = false; Mas permitindo que leiam algumas páginas: $wgwhitelistread = array ( "Página principal", "Especial:Entrar", "Ajuda:Conteúdos"); Permitindo o registro de novos usuários apenas por administradores: $wggrouppermissions['*']['createaccount'] = false;

Dever de casa O YEI não se contenta com um fórum (como se a gente pudesse falar muito disso).. eles querem também um Wiki. Com o mesmo prazo de entrega do fórum para o YEI, você deve fazer um Wiki para a instituição.

BOM PROJETO!! Ah!! A organização é internacional. Logo, tanto o fórum quanto o wiki devem estar em inglês.

Links importantes http://www.easyphp.org/ Onde você encontra a última versão para download http://www.mediawiki.org/ Onde você encontra a última versão para download http://www.mediawiki.org/wiki/manual:industrializ ation_guide Informações úteis para configuração do wiki para utilização em empresas.

Links importantes http://www.easyphp.org/ Onde você encontra a última versão para download http://www.mediawiki.org/ Onde você encontra a última versão para download E também diversos tutoriais, manuais e muitas outras informações úteis. http://www.mediawiki.org/wiki/manual:industrializ ation_guide Informações úteis para configuração do wiki para utilização em empresas.

Contatos importantes Cássio Alexandre Paixão Silva Alkmin E-mail: MSN: kcio89@nerdshack.com Tel: (31) 8813-3676