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

Table des Matières

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
{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.
The language selector list will look like this:
Choose your language:
Of course (unilke this example) it will actually do something when a new selection is made: the gallery language will change.
Back in cpg1.4.x, the token used to reside in all themes that came with coppermine out of the box and there used to be an option in coppermine's config to determine wether you wanted the language selector to appear or not. With cpg1.5.x the selector has been dropped from the themes and the option from the config panel, so you explicitely have to add the token to your template.html file to see the selector. By default, Coppermine does not display the language selector. The reason for the decision of the coppermine dev team to drop the selector out of the box is the fact that Coppermine's built-in mechanisms to detect a visitor's prefered language works so well that there is hardly ever a need to offer a language selector to your visitors. Only in the rare cases when you're convinced that your visitor's browser language probably is not the language they would prefer to see your gallery in should you provide a language selector.
This is for example the case for Luxembourg: the Grand Duchy of Luxembourg is a small country in Europe with three official languages:
  • French
  • German
  • Luxembourgish
With less then half a million inhabitants (and probably far less people actuall speaking Luxembourgish each day) the major browser creators don't provide a browser with Luxembourgish as prefered language. Subsequently, if your gallery catters for a Luxembourgian audience, it might make sense to add a language selector by editing themes/yourtheme/template.html and adding somewhere (preferably near the top of the screen) that allows your visitors to actually see the gallery's navigation in Luxembourgish (provided that there is a language file in Luxembourgish of course).
aucun optionel -
{LANGUAGE_SELECT_LIST} Sélecteur de Langue (liste)
Affiche une liste déroulante des langues disponibles pour l'utilisateur final.
The language selector list will look like this:
Of course (unilke this example) it will actually do something when a new selection is made: the gallery language will change.
It's merely a matter of taste if you use the language selector with flags or the one that displays a dropdown list of available languages, so basically what has been said above about {LANGUAGE_SELECT_FLAGS} applies to {LANGUAGE_SELECT_LIST} as well.
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