Aldeia Numaboa

O terceiro passo desta série de tutoriais será criar uma barra de ferramentas na área administrativa para o componente "Olá pessoal" (com_ola). Aqui já entra um pouco mais de programação, ou seja, a coisa começa a ficar um pouco mais emocionante

Í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

A barra de ferramentas

Todos os componentes do Joomla possuem uma barra de ferramentas com botões para salvar, deletar, editar, publicar, despublicar etc e tal. Será que precisamos de um monte de programação e de imagens para obter estas ferramentas? A boa notícia é NÃO - está tudo pré-fabricado no framework do Joomla, prontinho para ser usado. Veja como fazer.

O script que cuida da saída para a página

A saída para a página é feita através de código HTML, mas não se preocupe, não vamos ter que escrever uma única linha de HTML - vamos usar as funções do framework do Joomla que fazem isto pela gente.

Crie o script toolbar.ola.html.php no diretório /administrator/components/com_ola/:

<?php
defined( '_JEXEC' ) or die( 'Acesso restrito' );
 
class botoes_ola {
 
   function _EDITAR() {
      JToolBarHelper::save();
      JToolBarHelper::apply();
      JToolBarHelper::cancel(); 
   }
 
   function _DEFAULT() {
      JToolBarHelper::title( JText::_( 'Administrar Olá' ), 'generic.png' );
      JToolBarHelper::publishList();
      JToolBarHelper::unpublishList();
      JToolBarHelper::deleteList();
      JToolBarHelper::editListX();
      JToolBarHelper::addNewX();
   }
}
?>

Neste script criamos uma classe de nome botoes_ola. Esta classe possui duas funções, a _EDITAR e a _DEFAULT. Estas funções chamam o Ajudante da Barra de Ferramentas do Joomla, conhecido como JToolBarHelper. O ajudante possui uma porção de botões com seus respectivos scripts. Escolhemos alguns deles, como salvar (save), atualizar (apply) e cancelar (cancel). A coleção é bem grande, veja a seguir:

Método	Função	Botão
JToolBarHelper::addNew()	Adiciona novo
JToolBarHelper::addNewX()	Adiciona novo, mas antes chama hideMainMenu()
JToolBarHelper::apply()	Atualiza (aplica)
JToolBarHelper::archiveList()	Lista de arquivos arquivados
JToolBarHelper::assign()	Atribui
JToolBarHelper::back()	Voltar
JToolBarHelper::cancel()	Cancelar
JToolBarHelper::custom($task = '', $icon = '', $iconOver = '', $alt = '', $listSelect = true, $x = false)	Botão personalizado
JToolBarHelper::customX($task = '', $icon = '', $iconOver = '', $alt = '', $listSelect = true)	Botão personalizado
JToolBarHelper::deleteList()	Deletar lista de registros
JToolBarHelper::deleteListX()	Deletar lista de registros
JToolBarHelper::divider()	Separador de botões
JToolBarHelper::editCss()	Editar CSS
JToolBarHelper::editCssX()	Editar CSS
JToolBarHelper::editHtml()	Editar HTML
JToolBarHelper::editHtmlX()	Editar HTML
JToolBarHelper::editList()	Editar Lista
JToolBarHelper::editListX()	Editar Lista
JToolBarHelper::help()	Ajuda
JToolBarHelper::makeDefault()	Tornar padrão
JToolBarHelper::media_manager()	Gerenciar mídia
JToolBarHelper::preferences()	Preferências
JToolBarHelper::preview()	Pré-visualizar
JToolBarHelper::publish()	Publicar
JToolBarHelper::publishList()	Publicar Lista
JToolBarHelper::save()	Salvar
JToolBarHelper::spacer()	Espaçador de botões
JToolBarHelper::title()	Título
JToolBarHelper::trash()	Eliminar / Lixeira
JToolBarHelper::unarchiveList()	Desarquivar Lista
JToolBarHelper::unpublish()	Despublicar
JToolBarHelper::unpublishList()	Despublicar Lista