Coppermine Photo Gallery v1.5.x: Documentation et manuel

Table des matières

Modifier template.html

Le fichier template.html est le fichier central de chaque thème: il ne peut contenir que du code HTML/CSS/JavaScript (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 votre galerie 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 vraiment un conteneur mais plus un séparateur entre le contenu géré par les fonctions pageheader et pagefooter.

Important

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

Attention à ne pas effacer le conteneur {JAVASCRIPT} ce JavaScript est nécessaire 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'exception 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 Description Position pas défaut Nécessaire ? Dépendances
{LANG_DIR} Sens d'écriture de la langue
Les valeurs possibles sont LTR et RTL. Ne doit pas être modifié.
pageheader Obligatoire Complété par Coppermine, en fonction du sens de lecture de la langue choisie par l'utilisateur.
{CHARSET} jeu de caractères
Détermine le jeu de caractè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.
pageheader 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 prit en compte par les moteurs de recherche. Le visiteur humain voit la balise titre dans la fenêtre du navigateur.
pageheader Obligatoire La balise titre est générée par chaque fichier Coppermine (exemple: displayimage.php, thumbnails.php etc.), et géré par la fonction pageheader.
{META} Balise méta
Les balises méta dépendantes du contenu dynamique de la page sont insérées ici. Actuellement, Coppermine utilise la balise méta keywords(<meta name="keywords" content="CONTENU DYNAMIQUE ICI" />) et la balise méta refresh (<meta http-equiv="refresh" content="5; URL=REDIRECTION_PAGE" />).
Si vous souhaitez ajouter d'autres balises méta (par exemple, les méta-données author <meta name="author" content="Nom Prénom" />), ne remplacez pas ce conteneur, mais ajoutes votre balise méta après le conteneur {META}.
pageheader Obligatoire Complété dynamiquement par le script, (exemple: pour la balise méta 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).
pageheader Obligatoire n/a
{CUSTOM_HEADER} Haut de page personnalisé
Si l'option correspondant est 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 pouvez 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.
pageheader Optionnel 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 comprend déjà une bannière ou le nom de votre galerie est affiché.
pageheader Optionnel Nom de la galerie défini dans la configuration
{GAL_DESCRIPTION} Description de la galerie
Sera remplacé par la description de la galerie que vous avez définie dans la configuration lorsque le thème sera interprété. Vous pouvez effacer ce conteneur, en particulier si votre thème comprend déjà une bannière ou la description de votre galerie est affichée.
pageheader Optionnel Description 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ébarrassez de ce menu ou de certains de ses éléments, n'effacez pas le conteneur {SYS_MENU}, mais effacez les éléments que vous ne voulez pas voir afficher en modifiant le fichier theme.php.
pageheader Obligatoire
{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" / "Les mieux notées" / "Mes favoris" / "Par date" / "Rechercher"). Même si vous voulez vous débarrasser de ce menu ou de certains de ses éléments, n'effacez pas le conteneur {SUB_MENU}, mais effacez les éléments que vous ne voulez pas voir afficher en modifiant le fichier theme.php.
pageheader 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.
La liste de sélection de langue ressemble à ça:
Choisissez votre langue:
Bien entendu (avec cet exemple), cela fera quelque chose que quand une nouvelle sélection est faite: la langue de la galerie va changera.
Retour dans cpg1.4.x, le conteneur réside habituellement dans tous les thèmes qui accompagne Coppermine et il y avait une option dans la configuration de Coppermine afin de déterminer les conditions dans lesquelles vous vouliez que le sélecteur de langue apparaisse ou non. Avec cpg1.5.x le sélecteur a été abandonné des thèmes ainsi que l'option du panneau de configuration, de sorte que vous devez ajouter explicitement le conteneur à votre fichier template.html pour voir le sélecteur. Par défaut, Coppermine n'affiche pas le sélecteur de langue. La raison de la décision de l'équipe de développement de Coppermine de ne plus mettre le sélecteur de langue vient du fait que Coppermine intègre des mécanismes de détection de la langue préférée du visiteur si bien qu'il n'y a presque jamais le besoin d'offrir un sélecteur de langue à votre visiteurs. Ce n'est que dans les rares cas ou vous êtes convaincu que la langue du navigateur du visiteur, n'est probablement pas la langue qu'ils préfèrent voir en visitant votre galerie que vous devez fournir un sélecteur de langue.
C'est par exemple le cas pour le Luxembourg: le Grand-Duché de Luxembourg est un petit pays en Europe avec trois langues officielles:
  • Français
  • Allemand
  • Luxembourgeois
Avec moins d'un demi-million d'habitants (et probablement beaucoup moins de personnes parlant le luxembourgeois Actuellement chaque jour), les créateurs des navigateurs principaux ne fournissent pas un navigateur avec le luxembourgeois comme langue préférée. Par la suite, si principalement votre galerie est pour un public luxembourgeois, il peut être judicieux d'ajouter un sélecteur de langue à votre thèmes en éditant themes/votretheme/template.html pour ajouter quelque part (de préférence près du haut de l'écran) la galerie en luxembourgeois permettant à vos visiteurs de la voir avec cette langue (à condition qu'il existe un fichier de langue en luxembourgeoise, bien sûr).
Aucune Optionnel -
{LANGUAGE_SELECT_LIST} Sélecteur de langue (liste)
Affiche une liste déroulante des langues disponibles pour l'utilisateur final.
La liste du sélecteur de langue ressemble à ceci:
Bien entendu (avec cet exemple), cela fera quelque chose que quand une nouvelle sélection est faite: la langue de la galerie va changera.
Si vous utilisez le sélecteur de langue avec des drapeaux ou celle qui affiche une liste déroulante des langues disponibles c'est simplement une question de goût, donc en gros ce qui a été dit ci-dessus à propos de {LANGUAGE_SELECT_FLAGS} s'applique à {LANGUAGE_SELECT_LIST} également.
Aucune Optionnel
{THEME_SELECT_LIST} Sélecteur de thème (liste)
Affiche une liste déroulante des thèmes disponibles pour que l'utilisateur final puisse choisir.
Aucune Optionnel
{ADMIN_MENU} Menu administrateur
Affiche le menu administrateur.
pageheader Obligatoire L'administrateur doit être identifié. Les contrôles administrateurs ne doivent pas être cachés
{MESSAGE_BLOCK} Bloc des messages
pageheader 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 vous devez garder en mémoire que vous pouvez déplacer librement les conteneurs dans le fichier template.html tant que vous n'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 contenu généré par votre pied de page personnalisé Si vous n'utilisez pas la fonction haut de page personnalisé, vous pouvez 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.
pagefooter Optionnel Chemin pour l'inclusion du pied de page personnalisé défini dans la configuration
{VANITY} Icônes de courtoisies
Si votre thème personnalisé est valide, le conteneur {VANITY} sera remplacé par la mini bannière avec les liens vers PHP.net, mysql.com et les validations HTML et CSS des validateurs du W3C.
pagefooter Optionnel Aucune
{CREDITS} Crédits
Affichera le "Powered by Coppermine" sur votre page. Si ce conteneur est enlevé, le droit d'auteur sera affiché comme faisant partie du bloc {GALLERY}. Si vous voulez modifier (ou même enlever) le "Powered by Coppermine" regardez la section droit d'auteur-mentions légales dans le pied de page
pagefooter Optionnel Section des crédits définie dans theme.php