Parte 3 - Criando o componente (Back-end)
Função displayEntries() - Cria um lista com todas as mensagens existentes na tabela guestbook e permite linkar cada título ao ambiente de edição da mensagem;
Função editEntry() - Apresenta um formulário com a mensagem selecionada para a devida modificação; e
Vamos começar a criar o arquivo admin.guestbook.php no Eclipse. Para criar o arquivo, clique com o botão direito na janela do navegador sobre o projeto com_guestbook e selecione new -> phpFile. Defina o nome do arquivo como admin.guestbook.php. Na janela a esquerda, clique em admin.guestbook.php e digite as linhas de código, apertando ctrl+s para salvar.como mostra a figura abaixo:
Figura 1 - o código fonte do arquivo admin.guestbook.php
Agora vamos criar o arquivo guestbook.xml no Eclipse. Para criar o arquivo, clique com o botão direito na janela do navegador sobre o projeto com_guestbook e selecione new -> File. Defina o nome do arquivo como guestbook.xml. Na janela a esquerda, clique em admin.guestbook.php e digite as linhas de código, apertando ctrl+s para salvar. Quando você salve este arquivo, a janela irá mostrar o código, como a figura abaixo:
Figura 2 - O código fonte do arquivo xml
O Eclipse suporta o formato xml, por isso, se você clicar com o botão direito na janela do editor, o menu de contexto proporciona uma opção entitulada validar. Selecionar esta opção irá validar a formatação do xml e caso existam erros, serão visualizados por pequenos ícones em formato de bandeira vermelhas na margem esquerda.
Crie os scripts de instalação (install.sql) e desinstalação (uninstall.sql) do componente. Os dois arquivos permitirão a instalação e desinstalação automática do componente.
O próximo passo será gerar o arquivo compactado (.zip) do componente para a devida instalação. Para isso, acesse o easyeclipse e abra o seu projeto. Clique com o botão direito do mouse sobre a pasta com_guesbtook -> export -> Archive File -> Next
Agora você deve nomear o arquivo como com_guestbook.zip e clicar em Finish.
Figura 3 - O arquivo zip
Agora basta você instalar o componente normalmente através do menu Extensões -> Instalar/Desinstalar e criar um ítem de menu para o mesmo.
Figura 4 - Criando um item de menu para instanciar o guestbook
O hiperlink será exibido no front-end e uma vez clicado você terá acesso ao formulário de postagem de mensagens.
Figura 5 - Inserindo mensagens no livro de visitas
No back-end você poderá editar a mensagem postada pelo usuário.
Figura 6 - Administrando as mensagens postadas
:: Para baixar o código completo do componente, clique aqui.
Artigo traduzido e adaptado por Júlio Coutinho. O original, está publicado no capítulo 6 do livro Professional Joomla - Programador para Programador, de Dan Rahmel.
Terminamos assim esta série de tutoriais abordando a criação de um componente para o Joomla 1.5.x.
No próximo artigo iremos falar de Ajax.
