Informática Numaboa - Tutoriais e Programação
Componente 1.5 - Barra de Ferramentas
|
Sab 19 Jan 2008 19:57 |
- Detalhes
- Categoria: Joomla
- Atualização: Segunda, 02 Julho 2012 19:26
- Autor: vovó Vicki
- Acessos: 17284
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
- Componente 1.5 - O basicão
- Componente 1.5 - Como registrar
- 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/:
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 |
Definindo as tarefas
No diretório /administrator/components/com_ola/ crie o arquivo toolbar.ola.php com o seguinte script:
A única coisa meio diferente é a chamada para incluir o script toolbar.ola.html.php. O nome do arquivo a ser incluído precisa ser este porque a função getPath( ) com o parâmetro 'toolbar_html' vai criar o caminho para um arquivo cujo nome é formado por toolbar, seguido do nome do componente (toolbar.ola), seguido de html (toolbar.ola.html) com a extensão php (toolbar.ola.html.php).
Já fomos apresentados à classe JToolBarHelper. Agora é a vez da JApplicationHelper. Esta classe, o Ajudante da Aplicação Joomla, também possui uma porção de métodos (funções) muito úteis. Por enquanto, não vou entrar em detalhes - basta lembrar do getPath que, de acordo com o parâmetro, serve para obter o caminho de arquivos.
O resultado
Na área administrativa, clique em Componentes -> Olá Pessoal. A tela deve mostrar o seguinte:
A barra de ferramentas mostrada na Fig. 1 é a criada pela função _DEFAULT. Se você quiser ver a barra de ferramentas mostrada quando um item for editado, não adianta clicar no botão Editar porque ainda não existem registros para serem editados. è preciso colocar no endereço do browser http://www.seusite.com.br/administrator/index.php?option=com_ola&task=edit.
Atualizando o pacote de instalação
Se você criou os scripts acima diretamente no diretório indicado, é claro que não vai precisar re-instalar o componente. Mesmo assim, sempre é bom deixar as coisas arrumadas e, a única que falta, é atualizar o script de instalação e refazer o pacote. Então vamos lá:
Agora é só fazer um pacote zip com os arquivos ola.php, admin.ola.php, toolbar.ola.php, toolbar.ola.html.php e ola.xml e mais uma etapa está vencida 
Se quiser, faça o download do novo pacote de instalação.