Inicio com este, uma série de 4 (quatro) artigos, referentes a criação de módulos para o Joomla 1.5.x. Gradativamente iremos aumento o nível de dificuldade e o últimos módulo será para possibilitar o acesso à sua conta do google analytics, direto do backend do Joomla.
INTRODUÇÃO
Módulo ou "modules" são "place holders", ou seja, espaços reservados que irão apresentar algum tipo de conteúdo. Geralmente, o conteúdo é mostrado em "caixinhas" laterais.
São diversas as possibilidades de utilização de um módulo. Por exemplo, a caixa com o espaço para você digitar o seu nome de usuário e senha, é um módulo. O mod_login.
Neste primeiro artigo, iremos criar um módulo simples, cujo objetivo será mostrar na tela, a mensagem: "Alô Mundo."
Não entrarei em detalhes relativos a linguagem de programação PHP, portanto, tenha em mente que é necessário pelo menos conhecer o PHP, para criar seu módulo. Mãos à obra!
Construir um módulo em Joomla, por mais simples que seja, não é uma operação simplória e exige um nível maior de conhecimento técnico, uma vez que você estará programando em PHP e precisará conhecer os fundamentos do sistema. O módulo que iremos criar poderá ser usado mais tarde como um alicerce para que você desenvolva seus proóprios componentes e outros módulos mais complexos.
- O primeiro passo será criar um diretório para abrigar os arquivos do novo módulo. Preferencialmente o nome deste diretório deverá possuir o prefixo mod.
Figura 1 - criando o diretório mod_alomundo
- O próximo passo será criar o arquivo .php com as instruções que o módulo deverá executar. Para criar um script em php você não precisa de nenhum programa especial, basta usar o bloco de notas e começar a digitar. Lembre-se de salvar o arquivo com o nome de mod_alomundo.php e para tal, você precisará clicar em salvar como - todos os arquivos - mod_alomundo.php
Figura 2 - código PHP do módulo
- a linha número 1 inicia o script em php e é fundamental que você coloque a tag php, após o pois se você não colocar e o HOST estiver com a diretiva short tag do php.ini desabilitada, seu script não funcionará.
- a linha número 2 deve ser utilizada em qualquer extensão que você venha criar pois ela impede o acesso direto ao diretório garantindo a segurança do sistema ao impedir o acesso de hackers que tentam algum tipo de injection via navegação.
- a linha número 3 utiliza o comando echo do PHP, para enviar a mensagem de saudação na tela do usuário.
JText é a classe que será instanciada pelo Joomla para mostrar a mensagem e se você tiver no arquivo de linguagem do seu Joomla, a tradução, o texto exibido será o do arquivo de linguagem.
Por exemplo: no módulo o texto está como 'Hello world', porém seria exibido Olá mundo, desde que fosse criado um arquivo de configuração de linguagem para o módulo. - O próximo passo será criar o arquivo .xml no bloco de notas. Após digitar o código, você deverá salvar o arquivo dentro do diretório criado. Para tal, você deverá clicar em salvar como - todos os arquivos - mod_alomundo.xml
Figura 3 - o arquivo mod_alomundo.xml
- eu não vou entrar em detalhes sobre o arquivo .xml pois penso que ele é quase que autoexplicativo. - Se você desejar, poderá criar um arquivo de configuração de idioma, para traduzir o texto e colocar o arquivo no diretório language do Joomla.
- O próximo passo será compactar o script php e o arquivo xml, gerando um pacote .zip, no caso do windows ou um .tar no caso do GNU/LINUX. Lembre-se de nomear o pacote como mod_alomundo.zip.
Figura 4 - Pacote mod_alomundo.zip
- Agora basta instalar o módulo, através do backend do Joomla. Extensões - Instalar/Desinstalar - arquivo - upload arquivo e instalar.
Lembre-se que por padrão, os módulos ficam despublicados quando são instalados.
Figura 5 - Instalação com sucesso
- Resultado no Frontend do Joomla, após publicar o módulo
Figura 6 - O módulo Alô mundo publicado
