Qual a estrutura do diretório de temas mais comum?

From Joomla! Documentation

This page is a translated version of the page What is the typical template directory structure? and the translation is 100% complete.

Other languages:
català • ‎Deutsch • ‎English • ‎español • ‎فارسی • ‎français • ‎Nederlands • ‎português do Brasil

Estrutura de Diretório de Tema Típica

O CMS Joomla! usa uma estrutura de diretórios e arquivos que podem variar de um tema para outro.

  • Temas para o Site - aqueles que modificam o visual de um site - podem ser encontrados no diretório /templates. Por exemplo, se o tema se chamar "meutema", ele estará dentro desse diretório:
<path-to-Joomla!>/templates/meutema
  • Temas para o Administrator - aqueles que modificam o visual da área de administração do site - podem ser encontrados no diretório /administrator/templates directory. Por exemplo, se o tema do administrador se chamar "meutemaadmin", ele estará dentro do diretório:
<path-to-Joomla!>/administrator/templates/meutemaadmin

Diretórios de Temas

Um template Joomla! típico inclui os seguintes diretórios:

  • css - contém todos os arquivos .css
  • html - contém as substituições do temao para exibição de páginas do sistema e de módulos
  • images - contém todas as imagens usadas pelo template
  • language - contém arquivos de idiomas adicionais usados pelo temantains additional language files used by the template

Dependendo da complexidade e projeto do tema, também pode conter:

  • js - contém arquivos JavaScript usados em funcionalidades adicionais pelo template

Estrutura de Exemplo com Arquivos

O caminho típico de um tema é <root>/public_html/<nome-do-domínio>/template/<nome do seu tema> que contém os seguintes diretórios e arquivos baseados no seu tema.

/css
/html
/images
/javascript
/language
component.php
error.php
favicon.ico
index.php
templateDetails.xml
template_preview.png
template_thumbnail.png 


Arquivos dos Temas

O mais comum é o tema ter pelo menos os seguintes arquivos:

  • index.php
Apresenta a lógica para exibição e posicionamento de módulos e componentes.
  • component.php
Apresenta a lógica para exibição da página pronta para impressão, envio por e-mail etc.
  • error.php
Apresenta uma maneira de mostrar problemas, como a página 404, Páginas não encotrada.
  • favicon.ico
arquivo do favicon
  • template.css
Contém os aspectos de formatação e apresentação do tema, como margens, fontes, cabeçalhos, contorno de imagem, listagens etc. O arquivo .css pode estar localizado dentro do diretório /css.
  • templateDetails.xml
Guarda a meta-informação relacionada ao tema e é usado pelo Instalador e Gerenciador de Temas.
  • template_preview.ext - substitua .ext pela extensão do formato da imagem (.jpg, .png, .gif)
Geralmente uma imagem de 600x400 pixel que é apresentada quando se clica sobre a miniatura no Gerenciador de Temas: Temas, mas não no Gerenciador de Temas:Estilos. O administrador vê uma janela popup modal do tema antes de aplicá-lo ao Site.
  • template_thumbnail.ext - substitua .ext com o formato de extensão da imagem (.jpg, .png, .gif)
Geralmente uma imagem de 200x150 exibida na listagem no Gerenciador de Temas:Temas, mas não no Gerenciador de Temas:Estilos. O administrador pode ver essa miniatura antes de aplicar o tema ao Site.