Lors d'une nouvelle installation, PicsEngine ne dispose que d'un seul template appelé "default".
Tous les templates sont situés dans le dossier templates/.
Un template dispose d'un dossier nommé du nom du template. Vous aurez donc le dossier templates/default/.
Chaque template doit disposer d'un fichier template.xml dans son propre dossier. Le fichier XML du template default est donc à l'emplacement templates/default/template.xml.
Créons un nouveau template. Pour cela, il suffit de faire un nouveau dossier dans templates/. Nomons le mytemplate. Dans ce même dossier, créer un fichier template.xml avec le contenu suivant:
<?xml version="1.0" encoding="UTF-8" ?>
<template>
</template>
Voici donc la hiérarchie de votre template:
|- admin
|- templates
|- mytemplate
|- template.xml
En vous rendant dans le panneau d'administration de votre galerie, dans l'onglet Options catégorie Galerie, vous pouvez choisir votre nouvelle apparence.
Comme vous l'aurez remarqué, le contenu du template est quasiment vide. Et pourtant votre galerie fonctionne bien avec un template par défaut.
Le principe est assez simple. Votre nouveau template.xml ne sert que si les informations y sont citées. Si PicsEngine ne trouve rien, il va aller chercher dans le template original de la galerie qui est dans admin/gallery/template.xml. Le dossier admin/gallery/ contient aussi toutes les images utilisées par PicsEngine.
Si on veut modifier quelque-chose, on va regarder la structure du fichier admin/gallery/template.xml, copier le bout qui nous concerne et modifier les valeurs.
Notre fichier template.xml personnalisé est donc réduit aux changements par rapport au template original. On arrive donc à un fichier simple à éditer.
Un autre avantage est aussi que si dans le futur, PicsEngine utilisera d'autres fonctionnalités non répertoriées dans votre template.xml, il les trouveras toujours dans le template original.
Pour illustrer la modification de template, nous allons commencer par un exemple simple.
Nous allons modifier la couleur d'arrière-plan de PicsEngine. Ouvrons d'abord le fichier admin/gallery/template.xml qui pour rappel est le template original.
On constate que la couleur d'arrière plan est dans le noeud : template.background.color et que sa valeur est 000000, c'est-à-dire noir.
On va donc récupérer ce noeud et l'introduire dans notre nouveau template. Changeons aussi la valeur de la couleur en mettant FFFFFF (blanc) :
<?xml version="1.0" encoding="UTF-8" ?>
<template>
<background>
<color type="hex">FFFFFF</color>
</background>
</template>
Comme expliqué, quand la galerie PicsEngine va essayer de trouver le noeud template.background.color, elle va le chercher dans notre templates/mytemplate/template.xml, si elle ne le trouve pas, elle prendra la valeur par défaut dans admin/gallery/template.xml.