- Présentation
- Création
- Partie ressources
- Partie affichage et enregistrement
- theme.xml
- l'image du thème
- les répertoires de templates
Présentation
L'intérêt des thèmes est de pouvoir changer à la volée l'aspect graphique du site sans avoir à modifier une ligne dans son contenu.
Création
Un thème est en général consitué de ressources: les images, les javascripts, les feuilles des styles, ... et d'une partie dédiée à la présentation (le code HTML). Pour concevoir des thèmes, il faut, comme souvent dans l'esprit Copix séparer les problèmes.
Partie ressources
Pour ce qui est des ressources, elles se situent dans le répertoire www/themes de votre site. Dans ce répertoire, on trouvera, par exemple, un répertoire img pour les images, un répertoire styles pour les css, ... tout est libre et optionel.
Vous trouverez toutes les infomations nécessaires dans les pages CopixResource et Personnalisez les ressources.
Partie affichage et enregistrement
La partie dédiée à l'affichage est aussi une partie qui, comme pour les modules, permet l'enregistrement des thèmes dans Copix. Cette partie se trouve dans le répertoire project/themes/<nom_du_theme>.
Dans ce repertoire, il faudra ajouter un fichier theme.xml qui est la fiche signalétique du thème, une image du thème ainsi que des repertoires contenant le templace d'affichage.
theme.xml
Ce fichier contient les champs suivants:
- name: le nom du thème (par exemple "mon 1er thème")
- author: l'auteur du thème
- website: le site web de l'auteur du thème
- description: une description du thème par l'auteur
l'image du thème
Copix utilise aussi dans son système de choix de thème une image qui représente le thème. C'est optionnel mais cela permet d'avoir un aperçu rapide du thème. Cette image doit se trouver elle aussi à la racine du répertoire du thème.
les répertoires de templates
Les templates du thèmes permettent de se substituer aux templates d'un module. Copix utilise donc le nommage des templates du thème pour savoir quel template remplacer. Par exemple, considerons un module exemple qui contient dans son répertoire templates un template nommé mon_template.php. Il suffit de créer un nouveau template mon_template.php dans le répertoire project/themes/nom_de_mon_theme/exemple/mon_template.php.
Pour savoir si un template est surchargé ou pas, Copix va regarder dans l'ordre suivant:
- Le template du thème courant s'il existe
- Le template du thème "default" s'il existe
- En dernier lieu celui livré avec le module
Plus d'informations sur les templates dans la page template principal.