Aldeia Numaboa

Jumi é um módulo e um mambot/plugin universal de multi-uso. O que isto quer dizer? Significa que, com apenas um módulo e um plugin você pode criar todo tipo de módulo e plugin que quiser. Se você ficou assustado com a estrutura de arquivos necessária para criar módulos para o Joomla, então conheça o Jumi, uma solução altamente versátil e criativa.

O Jumi foi criado por Martin Hájek e no site do autor você encontra o Módulo Jumi (para Joomla 1.0.x e 1.5), o Plugin Jumi (para Joomla 1.0.x e 1.5) além de vários exemplos de aplicação e alguma documentação. Você também pode fazer o download destas extensões na seção de downloads da Aldeia em Webmaster/Joomla.

Exemplo de módulo

Ao invés de ficar explicando muitos detalhes, vamos a um exemplo de como criar um módulo a toque de caixa. Será um módulo bem simples que mostra um texto de copyright.

A primeira coisa a fazer é instalar o módulo apropriado para a sua versão do Joomla. Na área administrativa, instale-o como qualquer outro módulo. Até aí, nada de novo.

O grande lance do Jumi é que ele permite incluir qualquer tipo de código PHP, Javascript, HTML, DHTML e até txt na área do módulo. Nestes scripts podemos fazer de tudo, inclusive usando as variáveis e a base de dados do Joomla. Mas tem mais, também podemos incorporar aplicativos que nem são do Joomla!

O script

O nosso exemplo não é tão ambicioso: queremos apenas colocar na tela uma mensagem estática de copyright, como a mostrada acima. Então vamos lá! Abra seu editor de texto (use apenas editores de texto ASCII puro como o bloco de notas ou o TextPad) e crie o seguinte script:

<?php defined ( '_JEXEC' ) or die( 'Acesso restrito' ); ?>
 
<span align="center">
<img src="logoCC.gif"><br>
Exceto onde especificamente citado, todo material deste site está sob licença
<a href="http://creativecommons.org/licenses/by-nc-sa/2.5/br/" target="_blank">Creative Commons</a>
de Atribuição, Uso Não-Comercial e Compatilhamento pela mesma licença 2.5 Brasil
</span>

Este é um script PHP com apenas uma declaração, aliás importantíssima porque impede o acesso direto a este script. Lembre-se deste detalhe: em qualquer script que você for criar, comece sempre com esta primeira linha!

_JEXEC é uma variável global do Joomla versão 1.5 e, se ela não tiver sido definida (ou seja, o chamador não for o Joomla), o script "morre" (die) com a mensagem "Acesso restrito". Se a chamada tiver sido feita através do Joomla, o resto do script é executado. Nunca é demais repetir esta primeira linha. Como disse, para a versão 1.5 ela é:

<?php defined( '_JEXEC' ) or die( 'Acesso restrito' ); ?>

Para as versões 1.0.x:

<?php defined( '_VALID_MOS' ) or die( 'Acesso restrito' ); ?>

E, para atender todas a versões:

<?php defined( '_JEXEC' ) or defined( '_VALID_MOS') or die( 'Acesso restrito' ); ?>

Os marcadores <?php e ?> definem a área PHP deste script. Depois disto, segue uma área de HTML puro em que definimos a centralização do texto com <span align="center">...</span>. Entre estas duas tags colocamos uma imagem e nosso texto que contém um link.

Salve este script com a extensão .php, por exemplo, copyright.php. Agora chegou a hora de colocar este script no servidor.

Os scripts no servidor

Qualquer lugar é lugar, contanto que esteja no diretório raiz do Joomla ou algum dos seus subdiretórios. Por uma questão de ordem, já que este script deve ser incluído, uma boa escolha seria o diretório /includes. Para não misturar seus scripts com outros do Joomla, talvez fosse interessante criar um subdiretório do tipo /includes/jumi ou /includes/meusScripts. Faça o upload do seu script - digamos que tenha sido /includes/jumi/copyright.php.

Agora está tudo preparado para que possamos criar o módulo, mas antes uma palavrinha sobre caminhos (path). Lembre-se de que todas as páginas têm como referência o diretório raiz do Joomla. Se quisermos acessar nosso script precisamos referenciá-lo a partir do diretório raiz, ou seja, exatamente como mostrado acima. Da mesma forma, se no script houver alguma referência a outros arquivos ou scripts, eles precisam ser referenciados usando o mesmo critério.

Depois desta explicação, onde você acha que a imagem logoCC.gif precisa estar? No diretório raiz! E se ela estiver em /images/stories? A referência precisaria ser /image/stories/logoCC.gif