# Coppermine Photo Gallery v1.5.x: Documentation et Manuel

# Modifier template.html

Le fichier template.html est le fichier coeur de chaque thème: il ne peut contenir que diu code (pas de PHP!) plus des conteneurs qui seront remplacés par du contenu lorsque le thème est interprété (exemple: lorsque la sortie HTML des pages de votre galerie est générée). Template.html détermine l'aspect général des pages de votre galerie. Utilisez ce fichier pour faire en sorte que votr egalerie ait le même aspect que le reste de votre site.

## conteneurs (tokens) du thème

Lors de la modification du fichier "template.html" n'effacez pas les éléments entre {} - Ce sont les conteneurs utilisés par le script. Pensez que ces éléments placés entre accolades seront remplacés par la suite par du contenu dynamique lorsque votre thème sera interprété.
Vous pouvez déplacer ces conteneurs afin d'obtenir un aspect différent. Toutefois il y a quelques limites - en lien avec le conteneur principal {GALLERY}, qui n'est pas vraient un conteneur mais plus un séparateur entre le contenu géré par les fonctions pageheader et pagefooter.

## Important

Il y a des conteneurs optionels, que vous pouvez enlever sans risques du fichier template.html si vous n'avez pas besoin de la/des fonction(s) correspondant à ce(s) conteneur(s).

Attention à ne pas effacer le conteneur {JAVASCRIPT} - ce javascript est necessaire pour l'affichage de la fenêtre pop-up des images originales et à d'autres fonctions utilisant JavaScript. Si vous l'enlevez, vous ne remarquerez probablement rien en premier lieu, mais vous ne devez en aucun cas l'effacer ou votre galerie présentera des disfonctionnements.

Regardez la colonne "Nécessaire?" dans la liste des conteneurs du fichier template.html - ceux étiquetés "optionnel" peuvent être enlevés sans problèmes (à l'éxeption des fonctions correspondantes qui ne fonctionneront plus bien entendu).
Un bon exemple est le conteneur `{GAL_DESCRIPTION}` - Il affiche simplement ce que vous avez entré comme description de galerie dans la page de configuration. Si vous n'avez pas besoin de l'affichage de cette description sur chaque page de votre galerie Coppermine, effacez simplement le conteneur du fichier template.html.

## Liste des conteneurs (tokens) dans template.html

Conteneur | Déscription | Position pas défaut | Nécéssaire? | Dépendances
--- | --- | --- | --- | ---
{LANG_DIR} | Sens de'écriture de la Langue Les valeurs possiblessont LTR et RTL. Ne doit pas être modifié. | haut de page | obligatoire | Complété par Coppermine, en fonction du sens de lecture de la langue choisie âr l'utilisateur.
{CHARSET} | Jeux de Caractères Détermine le jeux de ccarctères utilisé - complète la balise HTML `<meta http-equiv="Content-Type" content="text/html; charset={CHARSET}" />`. Ne changez rien sauf si vous savez réellement ce que vous faites. | haut de page | obligatoire | Complété par Coppermine en fonction de l'encodage choisi par l'administrateur dans la configuration.
{TITLE} | Titre de la Page Le titre de la page qui est le plus souvent pris en compte par les moteurs de recherche. Le visiteur humain voit la balise titre dans la fenêtre du navigateur. | haut de page | obligatoire | La balise titre est générée par chaque fichier Coppermine (exemple: displayimages.php, thumnails.php etc...), et géré par la fonction pageheader.
{META} | Meta balises Les méta balises dépendantes du contenu dynamique de la page est inséré ici. Actuellement, Coppermine utilise la méta balises keywords (`<meta name="keywords" content="CONTENU DYNAMIQUE ICI" />`) et la meta balise refresh (`<meta http-equiv="refresh" content="5; URL=REDIRECTION_PAGE" />`). Si vous voulez ajouter d'autres méta balises (par exemple la meta balise author, comme `<meta name="author" content="Nom Prenom" />`), ne remplacez pas ce conteneur, mais ajoutes votre meta balise après le conteneur {META}. | haut de page | obligatoire | Compélét dynamiquement par le script, (exemple: pour la méta balise keywords basée sur le fichier mots clés).
{JAVASCRIPT} | JavaScript Ce conteneur a été ajouté dans cpg1.5.x il sera remplacé par `<script type="text/javascript" src="scripts.js"></script>` (ce qui est obligatoire pour faire fonctionner correctement Coppermine). N'enlevez pas ce conteneur, mais vous pouvez ajouter votre code javascript personnel en dessous (dans une nouvelle ligne). | haut de page | obligatoire | n/a
{CUSTOM_HEADER} | Haut de page personnalisé Si l'option correspondant eest définie dans la configuration, ce conteneur sera remplacé par le contenu généré par votre Haut de page personnalisé. Si vous n'utilisez pas la fonction haut de page personnalisé, vous pouver enlever le conteneur {CUSTOM_HEADER} de votre fichier template.html, mais il est préférable de le laisser en place si vous deviez décider d'utiliser la fonction par la suite. | haut de page | optionel | Chemin pour l'inclusion du haut de page personnalisé défini dans la configuration
{GAL_NAME} | Nom de la Galerie Sera remplacé par le nom de la galerie que vous avez défini dans la configuration lorsque le thème sera interprété. Vous pouvez effacer ce conteneur, en particulier si votre thème comprends déjà une banière ou le nom de votre galerie est affiché. | haut de page | optionel | Nom de la Galerie défini dans la configuration
{GAL_DESCRIPTION} | Déscription de la Galerie Sera remplacé par la déscription de la galerie que vous avez défini dans la configuration lorsque le thème sera interprété. Vous pouvez effacer ce conteneur, en particulier si votre thème comprends déjà une banière ou la déscription de votre galerie est affichée. | haut de page | optionel | Déscription de la Galerie défini dans la configuration
{SYS_MENU} | Menu Système Détermine la position du menu de premier niveau que l'utilisateur final verra sur votre page (celui qui contient les liens s'identifier/quitter). Même si vous voulez vous débarasser de ce menu ou de certains de ses éléments, n'éffacez pas le conteneur {SYS_MENU}, mais effacez les éléments que vous ne voulez pas voir afficher en modifiant le fichier theme.php. | haut de page | obligatoire | Liens s'Identifier/Quitter: Status de l'utilisateur (admin/enregistré/visiteur). Lien Téléchargement: droit de l'utilisateur acteul à télécharger (défini dans le gestionnaire de groupe). Lien s'Enregistrer: Autorise l'enregistrement de nouveaux utilisateurs activé/désactivé dans la configuration. Lien FAQ: Affiche la FAQ activé/désactivé dans la configuration.
{SUB_MENU} | Sous Menu Détermine la position du menu de second niveau que l'utilisateur final verra sur votre page (celui qui contient les liens "Albums" / "Derniers Téléchargements" / "Derniers Commentaires" / "Les plus populaires" / "Le mieux notées" / "Mes Favoris" / "Par Date" / "Rechercher"). Même si vous voulez vous débarasser de ce menu ou de certains de ses éléments, n'éffacez pas le conteneur {SUB_MENU}, mais effacez les éléments que vous ne voulez pas voir afficher en modifiant le fichier theme.php. | haut de page | obligatoire | n/a
{LANGUAGE_SELECT_FLAGS} | Sélecteur de Langue (drapeaux) Affiche une ligne de drapeaux qui représentent les langues disponibles pour l'utilisateur final. | aucun | optionel | -
{LANGUAGE_SELECT_LIST} | Sélecteur de Langue (liste) Affiche une liste déroulante des langues disponibles pour l'utilisateur final. | aucun | optionel | -
{THEME_SELECT_LIST} | Sélecteur de thème (liste) Affiche une liste déroulante des thèmes disponibles pour l'utilisateur final. | aucun | optionel | -
{ADMIN_MENU} | Menu Adminisrateur Affiche le menu administrateur. | haut de page | obligatoire | L'Administrateur doit être identifié. Les controles administrateurs ne doivent pas être cachés.
{MESSAGE_BLOCK} | Bloc des Messages | haut de page | obligatoire |
{GALLERY} | Galerie Conteneur spécial qui sera remplacé par le contenu de Coppermine. Dans l'introduction ci dessus, nous expliquions que vous pouvez déplacer les conteneurs dans le fichier template.html. Néanmoins, vous devez comprendre que le conteneur {GALLERY} est un conteneur spécial: Voyez le plus comme un séparateur que comme un conteneur. Lorsque le thème est interprété, le conteneur {GALLERY} sera remplacé par le contenu principal de la galerie. Les autres conteneurs se trouvant entre accolades, se trouvant avant {GALLERY} sont gérés par la fonction pageheader; les conteneurs qui viennent après {GALLERY} sont gérés par la fonction pagefooter. C'est pourquoi vus devez garder en mémoire que vous pouvez déplacer librement les conteneurs dans le fichier template.html tant que vou sn'inversez pas la position du conteneur que vous déplacez avec {GALLERY}. | n/a | obligatoire |
{CUSTOM_FOOTER} | Pied de Page personnalisé Si l'option correspondante est activée dans la configuration, le conteneur sera remplacé par le conteneu généré par votre pied de page personnalisé. Si vous n'utilisez pas la fonction haut de page personnalisé, vous pouver enlever le conteneur {CUSTOM_FOOTER} de votre fichier template.html, mais il est préférable de le laisser en place si vous deviez décider d'utiliser la fonction par la suite. | pied de page | optionel | Chemin poue l'inclusion du pied de page personnalisé défini dans la configuration
{VANITY} | Icones de courtoisies Si votr ethème personnalisé est valide, le conteneur {VANITY} sera remplacé par la mini banière avec les liens vers PHP.net, mysql.com et les validateurs HTML et CSS validators de W3C. | pied de page | optionel | aucun
{CREDITS} | Crédits Affichera le "Powered by Coppermine" sur votre page. Si ce conteneur est enlevé, le copyright ser aaffiché comme faisant partie du bloc {GALLERY}. Si vous voulez modifier (ou même enlever) le "Powered by Coppermine" regardez la section Copyright dans le pied de page | pied de page | optionel | Section des Crédits définie dans theme.php