Blog da Empresa Estúdio Site

Olá pessoal, gostaria de passar algumas dicas para transformar um sistema qualquer em php em um módulo JOOMLA.

Bem, Você deve estar se perguntando porquê deveria transformar meu programa em php em um módulo JOOMLA sendo que poderia simplesmente fazer uma chamada do meu programa através de um menu Wrapper? Sim, é verdade poderia sim, mas em minha opinião não fica muito bom e você não terá tanta flexibilidade quanto que utilizando um módulo.

Vou citar algumas vantagens em utilizar este recurso:

- Um vez que o sistema passou a ser um módulo, você poderá determinar um espaço (User1, user2, user3 etc…) em seu template para exibi-lo possibilitando uma maior flexibilidade.

- Maior facilidade na manutenção do site, porque até uma pessoa com pouco conhecimento em programação poderia instalar ou desinstalar o sistema bastando apenas ter conhecimento em JOOMLA é claro.

- Transformando um sistema em um módulo, você estará contribuindo para a ampliação dos recursos do JOOMLA.

Acredito que essas são as principais vantagens e existem muitas outras, mas agora Chega de teoria e vamos a prática ok.

O sistema que vou utilizar como exemplo para esse tutorial é nada mais nada menos que um formulário que realiza uma pesquisa em banco de dados próprio com base em algumas informações e parâmetros em seguida exibe o resultado em tela.

O Funcionamento do sistema é muito simples, mas servirá como um bom exemplo.

Arquivo frmbusca.php:

Arquivo principal do sistema,vou citar os pontos que devem ser alterados ok.

Linhas 5,6,7 e 8 : Alterar hostname, database, username e senha para conexão com o banco de dados.

Obs: Lembrando que temos que fazer isto manualmente por não estarmos utilizando os recursos da API do joomla.

Linha 15 : <form name=”form1″ method=”GET” action=”index.php” id=”busca”>Originalmente para este programinha funcionar, o action do form aponta para o proprio script “mod_frmbusca.php” mas como módulo, teremos que apontar o action para index.php.

Agora vamos criar os arquivos install e unistall que vamos utilizar em nosso módulo.

install.frm_busca.php

Este arquivo serve apenas para instalar o módulo.

uninstall.frm_busca

Este é o arquivo de desinstalação.

Agora vou mostrar o arquivo XML e explicar os pontos fundamentais. Este arquivo é muito importante, pois é responsável pela configuração do módulo no Joomla durante a instalação e se estiver algum detalhe errado dificilmente a instalação será bem sucedida.

Frmbusca.xml

Vamos depurá-lo:

<?xml version=”1.0″ encoding=”utf-8″?>

Se refere a versão do módulo em seguida a codificação que adoramos para este módulo.

<install type=”module” version=”1.5.0″>

Estamos passando para o Joomla o tipo de aplicação que vamos instalar no caso é um “module” mas poderia ser um “component” por exemplo. Em seguida estamos dizendo para qual versão do Joomla é este módulo, neste exemplo “1.5.0″.

<description>Sistema para cadastro de parceiros de negócio, representantes, franquias etc…</description>

Devemos explicar qual é o objetivo ou ação desse módulo.

<files>
<filename module=”mod_frmbusca”>mod_frmbusca.php</filename>
<filename>install.frm_busca.php</filename>
<filename>uninstall.frm_busca.php</filename>
</files>

Dentro dessas tags vamos citar cada um de nossos arquivos que fazem parte de nosso módulo sendo que o arquivo principal devemos utilizar a tag :

<filename module=”mod_frmbusca”>mod_frmbusca.php</filename>

Após ter repetido o procedimento é só compactar o arquivo em formato .zip e instalar no Joomla.

Clique aqui para baixar o módulo completo aí você poderá testar e alterar o código se desejar.

Bom pessoal é isso aí, sei que esse tutorial não passou de quebra galho, mas é apenas um começo aos poucos vamos evoluindo. Espero ter contribuído e despertado em você o interesse em desenvolver para o Joomla ou entender um pouco como funciona a estrutura de um módulo.
Em breve postaremos novos tutoriais para criar módulos e componentes mais completos e complexos com parâmetros administrativos e tudo.

Aguarde!

mar 08th by admin