Para criarmos um Joomla! 1.5 Módulo está em sua
forma mais básica dois arquivos:
um arquivo de configuração XML e um
arquivo de controlador de PHP.
O arquivo de configuração XML contém informações gerais sobre o módulo
(como será exibida no Gerenciador de Módulo na interface de administração do Joomla!), Bem como parâmetros de módulo,
que pode ser fornecido para afinar a
Aparência / funcionalidade do módulo.
O arquivo PHP fornece a lógica de
controle para o módulo. Um muito simples "Olá mundo" módulo pode mostrar algo
como isto.
/ modules / mod_hello_world / mod_hello_world.xml:
! Nota: é muito
importante, o nome do arquivo XML
corresponde ao nome do módulo. Caso contrário, o instalador irá instalar o
módulo, mas o Joomla não mostrará os parâmetros e informações adicionais armazenados em XML.
Basicamente, este arquivo XML apenas possui linhas com informações básicas sobre o módulo, como o proprietário, versão, etc, para identificação pelo Joomla! instalador e, em seguida, fornece parâmetros
opcionais que podem ser estabelecidas no Gerenciador de Módulo e acessados de dentro da lógica do módulo para afinar o
seu comportamento. Além disso, este arquivo informa o instalador quais arquivos devem ser copiados e instalados.
Observe que não incluímos uma referência na seção de arquivos para o arquivo XML.
/ modules / mod_hello_world / mod_hello_world.php:
O
que acontece quando este módulo é carregado é que Joomla! inclui
(através da diretiva include PHP) o arquivo mod_hello_world.php
e armazena a saída em um buffer de saída, que é então processado
para a saída da página. Este arquivo simplesmente produz a seguinte mensagem no conteúdo do site:
----------------------------------------------------------------------------------
Olá Tudo bem, como vai?
Desenvolvido
o primeiro modulo simples para Joomla 1.5.
----------------------------------------------------------------------------------
ao final da página.
/modules/mod_hello_world/index.html:
----------------------------------------------------------------------------------
<html><body
bgcolor="#FFFFFF"></body></html>
----------------------------------------------------------------------------------
Isso
realmente só ajuda a garantir que uma página padrão é exibido se o acesso direto ao diretório é tentado sem listar todos os outros arquivos no diretório. Não é necessário, mas é
uma boa prática.
Para empacotar esse módulo para distribuição e instalação, basta fechar os ficheiros em conjunto, por exemplo, no prompt de comando do Linux:
% cd
mod_hello_world
% zip
mod_hello_world.zip mod_hello_world.php mod_hello_world.xml index.html
Uma vez compactado com o format .zip bastará entrarmos na
administação do Joomla” 1.5 e instalarmos o nosso novo módulo!
Caso queiram baixar uma versão de exemplo para instalarem em seu Joomla! 1.5.26 ou 2.5.X, disponibilizo par download atraves deste link do SourceForge:
link.
