Detalhes

Categoria: Joomla

Atualização: Quinta, 18 Junho 2009 11:30

Autor: vovó Vicki

Acessos: 21136

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:

<br> Exceto onde especificamente citado, todo material deste site está sob licença Creative Commons de Atribuição, Uso Não-Comercial e Compatilhamento pela mesma licença 2.5 Brasil

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 é:

Para as versões 1.0.x:

E, para atender todas a versões:

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

Configurando o módulo

Vá para a área administrativa e entre na administração de módulos. Procure pelo Jumi.

Fig. 1 - Administração de Módulos - Jumi

Edite o módulo e observe a caixa de parâmetros (Fig. 2).

Fig. 2 - Parâmetros do Jumi

O primeiro campo é Module Class Suffix. Este pode ficar em branco. O segundo é File Pathname. É aqui que indicamos o caminho para o nosso script, ou seja, digite /includes/jumi/copyright.php. O campo seguinte é para os argumentos que devem ser passados para o script. Como não precisamos passar nenhum, este campo também deve ficar em branco. Por último está o campo Notepad, que é onde podemos colocar a descrição do módulo, autoria, data, descrição dos argumentos que devem ser passados, etc. São apenas lembretes e não são usados pelo módulo.

Está quase no fim... Escolha os itens de menu aos quais o módulo deve ser associado e, finalmente, dê-lhe um título e o publique, como mostrado na Fig. 3. Para sacramentar as coisas, clique no botão salvar (save).

Fig. 3 - Nome e publicação

Agora é partir para o abraço. Chame uma página no browser onde o módulo deve aparecer e lá está ele

Passando argumentos para o módulo

Digamos que o link do nosso texto costuma mudar e que, para facilitar a manutenção do módulo, queremos fazer as alterações na área de administração. Neste caso, o jeito é passar o endereço do link através de um argumento. Os argumentos são passados entre colchetes e podemos passar quantos quisermos. Todo texto que ficar fora de colchetes será ignorado.

Do outro lado, o script recebe os argumentos em um array, cujo nome é jumi. Assim, o primeiro argumento passado pode ser recuperado usando-se a variável $jumi[0], o segundo com $jumi[1] e assim por diante.

Como sabemos que o módulo só vai passar um argumento para o script, vamos prepará-lo para receber o endereço do link:

<br> Exceto onde especificamente citado, todo material deste site está sob licença Creative Commons de Atribuição, Uso Não-Comercial e Compatilhamento pela mesma licença 2.5 Brasil

Depois de alterar o script, volte a editar o módulo (não procure por jumi, já mudamos o título para Licença!). No campo dos argumentos podemos colocar simplesmente:

[http://creativecommons.org/licenses/by-nc-sa/2.5/br/]

ou escrever algo como:

link = [http://creativecommons.org/licenses/by-nc-sa/2.5/br/]

Como o texto fora dos colchetes é ignorado, o argumento passado é o mesmo nos dois casos: a string com o endereço desejado.

Criando novos módulos

Para criar novos módulos, faça um cópia de qualquer um dos seus módulos jumi. Edite o módulo copiado e defina seus detalhes e parâmetros. Isto é tudo o que você precisa fazer para criar quantos módulos quiser.

Considerações finais

A capacidade de criar verdadeiras aplicações com o módulo Jumi não tem limites. O módulo chama um script, que pode incluir outro script, que por sua vez pode incluir mais outro script e por aí afora. Como foi dito no início, os scripts podem ser PHP, HTML, Javascript e até bibliotecas inteiras como a biblioteca javascript MooTools, fantástica para criar efeitos especiais AJAX.

Se você gostou do módulo Jumi, experimente o mambot/plugin Jumi. Com ele você poderá fazer a mesma coisa na área de texto. O mambot/plugin é chamado com:

{jumi [caminho_do_script] [argumento1] [argumento2] ... }

Neste ponto, como exemplo, fiz uma chamada ao script do módulo usando o mambot/plugin Jumi. Veja o resultado:

A mecânica é a mesma, assim como a sintaxe. Espero que tenham gostado e que este tutorial seja útil. Como sempre, um grande abraço a todos.

vovó Vicki