= Criação de templates e temas =

Na API do Egroupware/Expresso é possível que o usuário escolha templates e temas como na figura abaixo:
[[BR]]
[[Image(temas_escolha.jpg,,center)]] 

A implementação desta funcionalidade foi desenvolvida visando flexibilizar o Expresso em qualquer instalação e atender aos gostos pessoais dos usuários. Além disto retirar códigos com caminhos embutidos que impedem atualizações do Expresso pois toda modificações seriam menores.

== Template ==
Template refere-se a Interface/Modelo. Esta opção agrupa:
 * Tela de login
 * Montagem e arranjo da tela
 * Comportamento dos elementos da tela incluindo barra de aplicações
[[BR]]

Cada módulo possui pela especificação da API a pasta templates. Dentro desta pasta cada template está organizado com arquivos .tpl, .css e .php. Se o administrador criar uma pasta dentro de phpgwapi/templates este novo template estará visível para o usuário escolhe-lo. Quando escolhido determinado template, todos os módulos que tiverem um template com o mesmo nome o utilizarão. Caso contrário o módulo utilizará a pata default.

Quando o administrador criar um novo template em phpgwapi (copiando uma pasta existente ou criando do zero), é aconselhável que utilize os templates default de cada módulo a fim de evitar esforço em atualizações do Expresso. Quando torna necessário utilizar um template distinto em determinado módulo isto pode ser feito só naquele módulo.

== Tema ==
A seleção de tema refere-se a cores,fontes e imagens. Isto torna quase todas as personalizações que dependem somente da aparência independentes de templates.
O exemplo abaixo mostra vários temas de um único template:

[[Image(temas.jpg,,center)]]

A criação de um tema é muito mais simples e encorajada a um template. Apesar de mais simples uma opção não substitui a outra, mas a opção de templates são personalizações mais pesadas no Expresso. Para criar um '''tema''' basta copiar um arquivo .css dentro de phpgwapi/templates/default/css/ (ou template de preferência). Depois de carregado o tema, a adaptação pode ser feita em tempo de execução no Expresso com uma extensão do tipo Firebug. E em seguida salvar no arquivo definitivo. As figuras podem ser guardadas em default ou no template modificado.

A idéia do tema (css) é de que ele já estará carregado quando o módulo for iniciado de forma que '''não é preciso''' recriar um a um dos css's dentro do módulos. Toda modificação que é feita por exemplo no expressoMail, apenas é feita no main.css, de forma que os outros temas não tenham que carregar esta modificação (não será preciso alterar todos os css's). Logo o css é apenas um tema geral do expresso sem especificidades dos módulos.

Veja mais informações em:
[/wiki/phpgwapi/temas/padroes Padrões de nomes dos temas]