Aldeia Numaboa

Com dois scripts muito simples você pode ver o componente "Olá Pessoal" em ação no área do site (frontend) e na área administrativa (backend). Este é o primeiro passo para entender como funcionam e como criar seus próprios componentes para o Joomla 1.5.

Componente na área do site (frontend)

Para produzir o componente mais simples possível para o frontend, vamos criar um diretório (pasta) por conta própria, colocar um script neste diretório e, para testá-lo, vamos chamá-lo diretamente pelo navegador (browser). Veja como:

1. Vá para /components/ e crie um diretório com o nome de com_ola.

Fig. 1 - Os diretórios da área do site

2. No diretório /components/com_ola/ crie o arquivo ola.php:

<?php
   defined( '_JEXEC' ) or die( 'Acesso restrito' );
   echo '<div class="componentheading">Olá pessoal!</div>';
?>

A primeira linha é OBRIGATÓRIA por uma questão de segurança. Ela impede que este script possa ser acessado diretamente sem passar pelo framework do Joomla. Nunca se esqueça dela!

A segunda e última linha põe um texto na tela. Poderia ser simplesmente echo 'Olá pessoal!', mas resolvi dar uma enfeitada e destacar o texto aplicando-lhe a classe "componentheading"

Porque escrevemos Olá ao invés de Olá? Como o Joomla 1.5 trabalha com o conjunto de caracteres UTF-8, letras acentuadas precisam ser substituídas pelos códigos adequados. O da letra a com acento agudo (á) é á que você consegue inserir com à seguido de alt+0161.

3. Para testar se o componente funciona, basta chamá-lo pelo browser. Abra seu navegador e coloque o endereço:

http://www.seusite.com.br/index.php?option=com_ola

onde www.seusite.com.br deve ser trocado pelo domínio do seu site ou por localhost se você estiver trabalhando com o Joomla numa estação local. O resultado deve ser o seguinte:

Fig. 2 - O resultado no frontend

Componente na área administrativa (backend)

Depois de fazer o componente do frontend, criar o do backend é um verdadeiro passeio. Como já sabemos, o primeiro passo é criar o diretório (ou pasta) do componente no backend.

1. Vá para /administrator/components/ e crie o diretório com_ola.

Fig. 3 - Os diretórios da área administrativa

2. Crie o arquivo admin.ola.php na nova pasta com as seguintes linhas de código:

<?php
   defined( '_JEXEC' ) or die( 'Acesso restrito' );
   echo 'Olá pessoal!';
?>

3. Para testar o componente, você precisa entrar na área administrativa fazendo login. No browser, troque o endereço http://www.seusite.com.br/administrator/index.php por:

http://www.seusite.com.br/administrator/index.php?option=com_ola

O resultado que você deve encontrar é o seguinte:

Fig. 4 - O resultado no backend

Observações

Mais simples do que isto, impossível. Acontece que estes componentes ficam meio soltos, dissociados do sistema. Não podem ser administrados (nem aparece no menu Componentes da área administrativa) e precisam ser chamados através do endereço dos seus scripts - diretamente ou através de um item do menu. Isto não é bom nem para nós e nem para os usuários, mas pode ser facilmente resolvido. Leia o tutorial Componente 1.5 - Como registrar para ver como isto é feito.