https://www.comercialsampa.com.br/suporte/index.php?

_m=knowledgebase&_a=viewarticle&kbarticleid=354

Jumi - O pulo do gato

Autor:

COMERCIAL SAMPA HOSTING

Data de cria05 November 2009 00:43

Jumi um mdulo e um mambot/plugin universal de multi-uso. O que isto quer dizer? Significa que, com apenas um mdulo e um plugin voc pode criar todo tipo de mdulo e plugin que quiser. Se voc ficou assustado com a estrutura de arquivos necessria para criar mdulos para o Joomla, ento conhea o Jumi, uma soluo altamente verstil e criativa. O Jumi foi criado por Martin Hjek e no site do autor voc encontra o Mdulo Jumi (para Joomla 1.0.x e 1.5), o Plugin Jumi (para Joomla 1.0.x e 1.5) alm de vrios exemplos de aplicao e alguma documentao. Voc tambm pode fazer o download destas extenses na seo de downloads da Aldeia em Webmaster/Joomla.

Exemplo de mdulo
Ao invs de ficar explicando muitos detalhes, vamos a um exemplo de como criar um mdulo a toque de caixa. Ser um mdulo bem simples que mostra um texto de copyright. A primeira coisa a fazer instalar o mdulo apropriado para a sua verso do Joomla. Na rea administrativa, instale-o como qualquer outro mdulo. At a, nada de novo. O grande lance do Jumi que ele permite incluir qualquer tipo de cdigo PHP, Javascript, HTML, DHTML e at txt na rea do mdulo. Nestes scripts podemos fazer de tudo, inclusive usando as variveis e a base de dados do Joomla. Mas tem mais, tambm podemos incorporar aplicativos que nem so do Joomla!

O script
O nosso exemplo no to ambicioso: queremos apenas colocar na tela uma mensagem esttica de copyright, como a mostrada acima. Ento 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 licena <a href="http://creativecommons.org/licenses/by-nc-sa/2.5/br/" target="_blank">Creative Commons</a> de Atribuio, Uso No-Comercial e Compatilhamento pela mesma licena 2.5 Brasil </span> Este um script PHP com apenas uma declarao, alis importantssima 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 varivel global do Joomla verso 1.5 e, se ela no tiver sido definida (ou seja, o chamador no for o Joomla), o script "morre" (die) com a mensagem "Acesso restrito". Se a chamada tiver sido feita atravs do Joomla, o resto do script executado. Nunca demais repetir
Page 1/3 Tel/Fax: (5511) 3717-4559

https://www.comercialsampa.com.br/suporte/index.php?_m=knowledgebase&_a=viewarticle&kbarticleid=354

esta primeira linha. Como disse, para a verso 1.5 ela : <?php defined( '_JEXEC' ) or die( 'Acesso restrito' ); ?> Para as verses 1.0.x: <?php defined( '_VALID_MOS' ) or die( 'Acesso restrito' ); ?> E, para atender todas a verses: <?php defined( '_JEXEC' ) or defined( '_VALID_MOS') or die( 'Acesso restrito' ); ?> Os marcadores definem a rea PHP deste script. Depois disto, segue uma rea de HTML puro em que definimos a centralizao do texto com .... Entre estas duas tags colocamos uma imagem e nosso texto que contm um link. Salve este script com a extenso .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 diretrio raiz do Joomla ou algum dos seus subdiretrios. Por uma questo de ordem, j que este script deve ser includo, uma boa escolha seria o diretrio /includes. Para no misturar seus scripts com outros do Joomla, talvez fosse interessante criar um subdiretrio do tipo /includes/jumi ou /includes/meusScripts. Faa o upload do seu script - digamos que tenha sido /includes/jumi/copyright.php. Agora est tudo preparado para que possamos criar o mdulo, mas antes uma palavrinha sobre caminhos (path). Lembre-se de que todas as pginas tm como referncia o diretrio raiz do Joomla. Se quisermos acessar nosso script precisamos referenci-lo a partir do diretrio raiz, ou seja, exatamente como mostrado acima. Da mesma forma, se no script houver alguma referncia a outros arquivos ou scripts, eles precisam ser referenciados usando o mesmo critrio. Depois desta explicao, onde voc acha que a imagem logoCC.gif precisa estar? No diretrio raiz! E se ela estiver em /images/stories? A referncia precisaria ser /image/stories/logoCC.gif

Configurando o mdulo
V para a rea administrativa e entre na administrao de mdulos. Procure pelo Jumi. Edite o mdulo e observe a caixa de parmetros (Fig. 2). 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 no precisamos passar nenhum, este campo tambm deve ficar em branco. Por ltimo est o campo Notepad, que onde podemos colocar a descrio do mdulo, autoria, data, descrio dos argumentos que devem ser passados, etc. So apenas lembretes e no so usados pelo mdulo. Est quase no fim... Escolha os itens de menu aos quais o mdulo deve ser associado e, finalmente, d-lhe um ttulo e o publique, como mostrado na Fig. 3. Para sacramentar as coisas, clique no boto salvar (save). Agora partir para o abrao. Chame uma pgina no browser onde o mdulo deve aparecer e l est ele

Passando argumentos para o mdulo

Digamos que o link do nosso texto costuma mudar e que, para facilitar a manuteno do mdulo, queremos fazer as alteraes na rea de administrao. Neste caso, o jeito passar o endereo do link atravs de um argumento. Os argumentos so 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
Page 2/3 Tel/Fax: (5511) 3717-4559

https://www.comercialsampa.com.br/suporte/index.php?_m=knowledgebase&_a=viewarticle&kbarticleid=354

argumento passado pode ser recuperado usando-se a varivel $jumi[0], o segundo com $jumi[1] e assim por diante. Como sabemos que o mdulo s vai passar um argumento para o script, vamos prepar-lo para receber o endereo do link: <?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 licena <a href="$jumi[0]" target="_blank">Creative Commons</a> de Atribuio, Uso No-Comercial e Compatilhamento pela mesma licena 2.5 Brasil </span> Depois de alterar o script, volte a editar o mdulo (no procure por jumi, j mudamos o ttulo para Licena!). 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 endereo desejado.

Criando novos mdulos

Para criar novos mdulos, faa um cpia de qualquer um dos seus mdulos jumi. Edite o mdulo copiado e defina seus detalhes e parmetros. Isto tudo o que voc precisa fazer para criar quantos mdulos quiser.

Consideraes finais
A capacidade de criar verdadeiras aplicaes com o mdulo Jumi no tem limites. O mdulo 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 incio, os scripts podem ser PHP, HTML, Javascript e at bibliotecas inteiras como a biblioteca javascript MooTools, fantstica para criar efeitos especiais AJAX. Se voc gostou do mdulo 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 mdulo usando o mambot/plugin Jumi. Veja o resultado: Fonte: Numa Boa Comercial Sampa Hosting (11) 3717-4559

Page 3/3 Tel/Fax: (5511) 3717-4559