quarta-feira, 20 de novembro de 2013

diretório /images/ (ou /imagens/, como quiser) também foi convencionado por uma questão de ordem. Contém todas as imagens usadas no template e o arquivo logo.png foi citado apenas como um exemplo.
A esta altura, a estrutura de um template já se tornou um pouco mais complexa, mas isto não altera o fato de que apenas dois arquivos são absolutamente necessários. São estes que veremos a seguir em maiores detalhes.

O arquivo templateDetails.xml

Este é um arquivo de metadados no formato XML que informa ao Joomla quais são os arquivos necessários quando uma página que usar este template for carregada. Ele também informa o autor, o copyright e quais arquivos e imagens compõem o template. Finalmente, este arquivo também é necessário para que o template possa ser instalado através da área administrativa.
Veja um exemplo:
meuTemplate 1.0.0 06.01.09 vovo Vicki vovo @numaboa.com www.numaboa.com Creative Commons by-nc-sa version 2.5 Meu primeiro template index.php templateDetails.xml template_thumbnail.png css/template.css images/logo.png breadcrumbs left right top user1 Vamos por partes para descobrir o que este arquivo XML contém, mas antes de começar, dois avisos:
atencao NÃO USE ACENTOS, o XML odeia letras acentuadas porque indicamos a codificação utf-8! Foi por isto que na linha 6 coloquei vovo Vicki ao invés de vovó Vicki.
atencao NÃO MUDE A SEQÜÊNCIA dos marcadores. Se fizer isto, o XML se embanana todo, dá erro na hora de instalar o template e a gente fica procurando que nem doido onde o erro pode estar e dificilmente o encontra.
  • Linha 1: indica que este é um arquivo XML versão 1.0 com codificação utf-8.
  • Linha 2: diz que se trata de um arquivo de instalação (install) para a versão 1.5 do Joomla e que se trata da instalação de um template. Observe que o marcador <install...> possui no fim do arquivo um marcador de fechamento </install>.
  • Linha 3: nome do template.
  • Linha 4: versão do template.
  • Linha 5: data da criação do template.
  • Linha 6: autor do template.
  • Linha 7: endereço de email do autor.
  • Linha 8: endereço do site do autor.
  • Linha 9: tipo de copyright.
  • Linha 10: versão do tipo de copyright.
  • Linha 11: descrição do template.
  • Linha 12: abre uma área para definir os arquivos que compõem o template com o marcador <files>.
  • Linhas 13 a 17: entre os marcadores <filename> e </filename> indicamos os nomes dos arquivos e seus diretórios.
  • Linha 18: fim da área dos arquivos indicada pelo marcador </files>.
  • Linha 19: início da área de posições com o marcador <positions>.
  • Linhas 20 a 24: entre os marcadores <position> e </position>, indicação de que left (esquerda), right (direita), top (topo), etc são nomes de posições que devem ser aceitos no template.
  • Linha 25: fim da área de posições.
  • Linha 26: início da área de parâmetros que podem ser passados para o template.
  • Linha 27: parâmetro "cor", do tipo lista.
  • Linhas 28 e 29: duas opções de cor - Azul e Vermelho.
  • Linha 30: fim da área do parâmetro.
  • Linha 31: fim da área de parâmetros.
  • Linha 32: fim da área de instalação.

0 comentários:

Postar um comentário