Un thème est un répertoire dans var/themes/. Ce répertoire contient un répertoire pour chaque theme, et dans chaque répertoire de theme, des répertoires correspondant à chaque module et contenant les templates.

Par exemple, vous voulez adapter le template main.tpl du module "exemple", pour le thème "web20", vous stockerez un fichier main.tpl dans var/themes/web20/exemple/. Notez donc que le template original et le nouveau template possèdent le même nom.

Le thème par défaut ayant pour nom "default", si vous voulez redéfinir un template d'un module, même si vous n'utilisez pas explicitement les thèmes, vous placerez ce template dans var/themes/default/le_module/le_template.tpl.

Par fichier web, on entend les fichiers CSS, les images etc... Ces fichiers ne doivent pas être placés dans var/themes/ car var n'est pas censé être accessible publiquement depuis le web.

Vous les placerez donc dans un répertoire themes/le_nom_du_theme/ dans le répertoire de base de votre application (basePath), en général donc dans www/

Pour avoir le chemin web du theme, vous pouvez utiliser ceci :

   $chemin = jApp::config()->urlengine['basePath'].'themes/'.jApp::config()->theme.'/'
   $rep->addCssLink($chemin.'design.css');

Dans un template, vous avez une facilité en utilisant la balise meta :

{meta_html csstheme 'design.css'}

D'autres sont disponibles pour les feuilles de styles spéciales pour IE

{meta_html cssthemeie 'design.css'} pour ie
{meta_html cssthemeie7 'design.css'} pour ie7
{meta_html cssthemeltie7 'design.css'} pour ie < 7

Mais vous avez aussi une variable déclarée automatiquement, j_themepath, dans un template contenant le chemin des thèmes

  <img src="{$j_themepath}logo.png" alt="logo"/>

L'activation d'un thème se fait dans le fichier de configuration, au niveau du paramètre theme :

theme = web20

Pour offrir la possibilité à l'internaute de choisir son thème, vous pouvez lui proposer un formulaire avec la liste des thèmes (liste que vous construisez vous même).

Ensuite vous stockez le nom du thème choisi quelque part (en session, ou dans un cookie par exemple).

Enfin, pour que le thème soit activé automatiquement, il suffit de récupérer le nom du thème correspondant à l'utilisateur, et de le spécifier dans la configuration, au niveau du paramètre thème:

  jApp::config()->theme = $themeChoisi;

Bien sûr, le meilleur endroit pour faire ça est dans un plugin de coordinateur qu'il vous faut développer.