Modificando o phpBB 2.0.x - Instalação de MODs

Sexta-feira, 20 de Abril de 2007. 12:02:06
Sobre Fóruns |

Como falei no meu review sobre o phpBB um dos principais problemas do sistema é o fato dele não ser modular. Isso significa que praticamente toda mudança e acréscimo de função precise ser feita “na unha” programando os códigos de mudança. Para facilitar um pouco o processo os criadores do sistema criaram um padrão de documentação dos MODs, que nada mais é do que um passo-a-passo para realizar as mudanças para determinada função. Este artigo aborda um pouco esta documentação, para facilitar quem está começando com o sistema e deseja personaliza-lo.

Antes de mais nada, se você não tem a MENOR noção do idioma inglês e uma pequena noção de programação eu recomendo tentar se aprofundar nestes quesitos antes de tentar instalar MODs complexos. Apesar de existir uma documentação padrão, nem todos os MODs seguem ela (a maioria sim felismente). Além disso alguns processos não são passo-a-passo, mas sim são descrições de atividades que devem ser feitas. Tudo isto é em inglês. Outro fator importante a se observar é que para poder modificar os arquivos, você precisa ter acesso a eles. Isto que dizer que, se você, como muita gente, tem um fórum pré-moldado (daqueles que você só preenche alguns campos e o serviço cria o fórum pra você) não poderá modificar nada. Se você quer sair dessa, contrate um serviço de hospedagem de sites, dê uma lida no tutorial de instalação do phpBB e tenha seu fórum totalmente do seu jeito…

Bem, se você não tem nenhum problema (ou pelo menos poucos) com o idioma você verá que o processo de instalação é relativamente simples. Cada você normalmente vem zipado (com os arquivos anexos do MOD e seu instalador) ou então em um arquivo único .mod ou .xml (nestes caso abra-o no navegador). O arquivo de instalação do MOD é um arquivo qeu contém as instruções de instalação. Ele tem basicamente o nome do arquivo que você deve abrir, um trecho de código a ser localizado e uma ação a ser feita (adicionar algo depois, modificar, etc).

Segue abaixo alguns comandos padrão para a instalação de MODs, com exemplos:

#
#-----[ SQL ]------------------------------------------
#
update phpbb_users set username='Sys.GSM' where user_id=2;

Este comando indica que você deve realizar uma mudança no banco de dados. AS mudanças são exatamente as consultas que vem. Copie as consultas, salve no bloco de notas e use a função “recuperar backup” para fazer esta mudança.


#
#-----[ OPEN ]-----------------------------------------
#
index.php

Indica que você deve abrir o arquivo para edição. Abra usando um programa editor de textos qualquer (Usando o bloco de notas em alguns casos o código pode aparecer enbaralhado, basta abrir usando qualquer outro programa, salvar o arquivo, sempre com o mesmo nome e abrir novamente.). Enquanto não for solicitado que se abra outro arquivo, todas as mudanças seguintes serão feitas neste arquivo aberto.


#
#-----[ FIND ]-----------------------------------------
#
$total_users = get_db_stat('usercount');

Este comando indica que você deve localizar um trecho de código no arquivo aberto anteriormente no OPEN. Deve-se localizar exatamente o que se pede. A importãncia de saber um poucode programação é que em alguns casos não se localiza exatamente o qeu se pede (por mudanças anteriores feitas por outros MODs ou mesmo atualizações de versão) e neste caso é preciso adaptar o código para que o mod funcione.


#
#-----[ IN-LINE FIND ]----------------------------------
#
{BOX_NAME} :: {L_MESSAGE}

Comando semelhante ao FIND, só que ao invés de localizar uma linha inteira, deve-se localizar parte de uma linha.


#
#-----[ REPLACE WITH ]---------------------------------
#
$total_users = "Indefinido";

Usado me conjunto com o FIND. Indica que o trecho localizado deve ser totalmente substituído pelo comando.


#
#-----[ IN-LINE REPLACE WITH ]-----------------------
#
{L_MESSAGE} -> {BOX_NAME}

Usado em conjunto com o IN-LINE FIND, indica que o trecho localizado na linha deve ser substituído pelo comando.


#
#-----[ AFTER, ADD ]-----------------------------------
#
$texto = "texto depois";

Usado em conjunto com o FIND. Define que, depois do trecho localizado, numa nova linha, deve-se adicionar o comando.


#
#-----[ BEFORE, ADD ]-----------------------------------
#
$texto = "texto antes";

Usado em conjunto com o FIND. Define que, antes do trecho localizado, numa nova linha, deve-se adicionar o comando.


#
#-----[ IN-LINE AFTER, ADD ]-------------------------
#
{COMANDO}

Usado em conjunto com o IN-LINE FIND, deve-se adicionar o comando na mesma linha localizada, após o comando localizado.


#
#-----[ IN-LINE BEFORE, ADD ]-------------------------
#
{COMANDO}

Usado em conjunto com o IN-LINE FIND, deve-se adicionar o comando na mesma linha localizada, antes o comando localizado.


#
#-----[ COPY ]-----------------------------------------
#
opy root/templates/subSilver/images/topic_bin.gif to /templates/subSilver/images/topic_bin.gif

Indica que deve-se copiar um arquivo que se encotra em um diretório (normalmente o diretório onde se descompactou o install do MOD) para uma pasta dentro do diretório do fórum.


#
#-----[ SAVE/CLOSE ALL FILES ]-------------------------
#
# EoM

Indica o fim do install do MOD, deve-se fechar (e salvar!) todos os arquivos modificados.

Estes são apenas alguns (os mais usados) comandos.
É bom destacar que os MODs padrão levam em consideração o idioma inglês e o template SubSilver (padrão do fórum). Se você tem outro(s) idiomas ou template(s) instalados. Os passos que solicitam alterações em arquivos dentro dos diretórios /languages e /templates devem ser feitos para todas as pastas e não somente para a /lang_english (no caso do idioma) e /subSilver (no caso dos templates).

Espero que este texto lhe ajude a personalizar seus fórum.

Outras referências sobre o assunto:
Tutorial de instalação por Suporte phpBB: www.suportephpbb.org/forum/viewtopic.php?t=33080
Tutorial em Flash pro phpBB Brasil:
www.phpbbrasil.com.br/index.php?fuseaction=flashtutos.InstalandoMods