🌍
Français
Table des matières
Fiche
| Niveau de difficulté : | n/c. |
|---|---|
| Recommandations : | n/c. |
| A lire aussi : | n/c |
Cette page n'est pas révisée. Cela signifie qu'elle n'est peut-être plus à jour et que les informations qu'elle contient peuvent se révéler obsolètes.
Merci pour votre compréhension.
Page à réviser !
Réaliser un template-extension (modèles)
A partir de la version 2.0.x, la possibilité d'utiliser un fichier .tpl alternatif à celui utilisé normalement par défaut est offerte.
Le premier élément à lire est le 
dans votre interface d'administration de la page Templates (modèles)
Nous allons expliquer la procédure à travers un exemple.
Le pourquoi du comment
Avant de se lancer dans de grandes démonstrations, il faut savoir qu'un template (fichiers aux extension .tpl) n'est ni plus ni moins qu'un type de fichier qui va donner des instructions pour l'affichage de vos pages. C'est ainsi, grâce aux templates, que l'on modifiera l'apparence pour tel ou tel besoin.
Toutefois, si modifier un template est réalisable avec n'importe quel éditeur de texte, conserver VOS modifications s'avérera impossible si vous modifiez le fichier original livré par Piwigo.
Aussi, il est donc vivement recommandé d'utiliser des ”template-extension”.
Le template-extension
Le template-extension est littéralement une extension de template. En d'autres termes : un fichier qui viendra compléter d'autres fichiers.
Sa création est très logique : on partira d'un fichier original que l'on dupliquera et que l'on modifiera selon ses envies. Votre propre fichiers viendra ainsi remplacer le fichier original. Vous conservez du coup le fichier original et donc lors d'une mise à jour, votre propre fichier (qui portera un nom différent du fichier original) ne sera pas affecté.
Créer son fichier personnalisé
Deux possibilités. Soit vous dupliquez un fichier existant, soit vous êtes bidouilleur et vous partez d'une page vierge. Seul changera le champs ”Modèle”
Mise en œuvre
Rendez vous dans [ Administration » Spéciales » Plugins » LocalFiles Editor > onglet Templates ]
Cliquez sur ”Créer un nouveau fichier“
L'écran ci-après apparaît.
- Nom du fichier : Entrez un nom de fichier. Le nom de mon nouveau fichier sera quelque chose comme ”my-picture.tpl” ou ”picture-perso.tpl”…
- Dossier parent : Par défaut laissez templates-extension. Seuls les plus assurés se risqueront à changer.
- Modèle : Nous pouvons partir soit d'un document vierge, soit d'un document déjà existant qui nous servira de modèle. Pour notre exemple, choisissons le fichier picture.tpl
Personnaliser son fichier .tpl
Dans le mesure où vous travaillez maintenant sur une copie du fichier original, vous pouvez apportez toutes les modifications que vous souhaitez. Votre fichier original sera toujours préservé.
Appliquer son fichier template-extension
Ce n'est pas le tout de faire et d'adapter un fichier à votre guise. Il faut maintenant dire à Piwigo de prendre en considération non plus le fichier original mais le vôtre. Rien de compliqué. Suivez le guide.
Rendez vous dans [ Administration » Configuration » Templates (modèles) ]
Dans le tableau, apparaît une liste de 4 colonnes.
- Remplaçants (templates modifiés) Fichiers qui serviront au remplacement. Dans cette liste, certains fichiers ne sont pas de vous. Ils ont été installés avec Piwigo et sont là pour vous servir d'exemples.
- Templates d'origine C'est le fichier que vous allez remplacer par le vôtre.
- Paramètre facultatif de l'URL Sauf si vous savez ce que vous faites, laissez ce champ vide.
- Template rattaché Les effets seront visibles uniquement sur le template que vous choisirez dans cette liste.