Aldeia Numaboa

Nesta quarta etapa do Componente 1.5 vamos aprender como criar uma tabela na base de dados do Joomla para armazenar informações referentes apenas ao componente "Olá Pessoal".

Índice da série de tutoriais Componente 1.5

1. Componente 1.5 - O basicão
2. Componente 1.5 - Como registrar
3. Componente 1.5 - Barra de Ferramentas
4. Componente 1.5 - Tabela de Dados

Três métodos para criar uma tabela

Podemos criar a tabela na linha de comando do console, usando um gerenciador de banco de dados via web (como o PHPMyAdmin) ou através do arquivo de instalação do componente.

Se você tem acesso direto ao banco de dados, execute a seguinte query na linha de comando do console (se o prefixo das suas tabelas forem jos_):

CREATE TABLE `jos_ola` (
`id` INT( 11 ) NOT NULL AUTO_INCREMENT PRIMARY KEY,
`mensagem` TEXT NOT NULL,
`published` TINYINT( 1 ) NOT NULL
);

Se você tiver um gerenciador, use-o para criar uma tabela com os mesmos campos citados na query.

Se você não tiver nenhum dos dois, só resta criar a tabela através do arquivo xml de instalação:

<?xml version="1.0" encoding="iso-8859-1" ?>
<install type="component" version="1.5.0">
  <name>Ola</name>
  <creationDate>19.01.2008</creationDate>
  <author>vovó Vicki</author>
  <copyright>Creative Commons</copyright>
  <authorEmail>webmaster arroba numaboa.com.br</authorEmail>
  <authorUrl>www.numaboa.com</authorUrl>
  <version>1.1 J1.5 RC4</version>
  <license>Creative Commons by-nc-sa</license>
  <description>Componente simples para dizer Olá pessoal!</description>
 
  <files>
     <filename>ola.php</filename>
  </files>
 
  <administration>
     <menu>Olá Pessoal</menu>
     <files folder="admin">
        <filename>admin.ola.php</filename>
        <filename>toolbar.ola.php</filename>
        <filename>toolbar.ola.html.php</filename>
        <filename>tables/ola.php</filename>
  </files>
  </administration>
 
  <install>
     <queries>
        <query>DROP TABLE IF EXISTS `#__ola`;</query>
        <query>CREATE TABLE `#__ola` (
           `id` int(11) unsigned NOT NULL auto_increment,
           `mensagem` text NOT NULL default '',
           `published` tinyint(1) NOT NULL default '0',
           PRIMARY KEY  (`id`)
           ) TYPE=MyISAM CHARACTER SET `utf8`;
        </query>
     </queries>
  </install>
  <uninstall>
     <queries>
        <query>DROP TABLE IF EXISTS `#__ola`;</query>
     </queries>
  </uninstall>
</install>

Veja que as queries para criar a tabela jos_ola foram colocadas na seção <install>, subseção <queries>. Você pode usar quantas queries forem necessárias para criar uma ou mais tabelas.

Observe que foi inserida uma query para eliminar a tabela quando o componente for desinstalado. É uma boa prática e uma questão de respeito com outros usuários não deixar tabelas inúteis na base de dados.

Volto a repetir: cuidado com os backticks ( ` ) para os nomes dos campos e tabelas e com as aspas simples ( ' ) para os valores!

Cuidado com a sintaxe do xml. Qualquer errinho e o Joomla vai dar uma mensagem de erro de que não encontrou o arquivo de instalação (não diz que existe um, mas que tem erros) ou uma mensagem de query com problemas.

Aproveitando o embalo, já que estamos mexendo no script de instalação, resolvi incluir o script mostrado a seguir e dar uma ordem nos diretórios. Na máquina local criei o diretório admin para colocar os scripts e os novos diretórios da área administrativa. A árvore agora está assim (os diretórios são mostrados entre colchetes):

[com_ola] |
          |- [admin] |
                     |- [tables] |
                                 |- ola.php
                     |- admin.ola.php
                     |- toolbar.ola.html.php
                     |- toolbar.ola.php
          |- ola.php
          |- ola.xml

Para atender a nova disposição dos arquivos, no marcador da seção < < entrou um novo parâmetro, folder="admin", para indicar o diretório base dos scripts da área administrativa.