Joomla! Documentation™

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.