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

# Création de votre thème personnalisé

## Commencez par renommer votre thème

Pour crée un nouveau thème, la meilleure solution est d'en utiliser un existant comme base en en faisant une copie. Pour faire cela, faites une copie du répertoire du thème que vous voulez utiliser comme base et renommez le nouveau dossier. Puis modifiez les fichiers "template.html", "style.css" et "theme.php" et remplacez toutes les occurrences de "themes/ancien_repertoire_du_theme" par "themes/nouveau_repertoire_du_theme" afin de faire pointer tous les liens vers la bonne place.
Evitez d'utiliser des espaces et des caractères spéciaux dans le nom de votre thème personnalisé - n'utilisez que des caractères alphanumériques et des caractères de soulignements (_).

Gardez en mémoire que même si ces fichiers sont situés dans le répertoire "themes/repertoire_de_votre_theme" ils doivent être codés comme si ils étaient à la racine de votre installation Coppermine. Par exemple, pour afficher une image vous devez utiliser `<img src="themes/repertoire_du_theme/images/image.gif" alt=""/>` et pas uniquement `<img src="images/image.gif" alt=""/>.` Le même principe s'applique pour le fichier "theme.php".

- Créez une copie
  Allez dans le répertoire de votre galerie Coppermine sur votre serveur et naviguez vers le répertoire des thèmes (`votre_repertoire_coppermine/themes/`), faites un clic droit sur le nom du répertoire du thème que vous voulez utiliser comme base de votre thème personnalisé (dans cet exemple, nous utiliserons le thème classic, nous utiliserons donc `votre_repertoire_coppermine/themes/classic/`), sélectionnez "copier" sélectionnez "copier" du menu contextuel. Puis collez le contenu du presse papier dans le répertoire theme; un répertoire (nommé "Copie de classic" ou similaire) sera créer.
- Renommez le répertoire
  Faites un clic droit sur le répertoire nouvellement crée (`votre_repertoire_coppermine/themes/Copie de classic/`) et sélectionnez "renommer" dans le menu contextuel. Choisissez un nom de thème unique - dans cet exemple nous utiliserons "mon_theme" (le résultat sera le renommage du répertoire en `votre_repertoire_coppermine/themes/mon_theme/`).
  Gardez en mémoire que nous téléchargerons le thème sur votre serveur web plus tard - Vous devais vous assurer d'utiliser les capitales correctement: sur un client piloté par Windows, les capitales n'ont pas d'effet, il n'y a donc pas de différence entre "`mon_theme`" et "`Mon_theme`". La plupart des serveurs sont pilotés par Linux, ou les capitales ont une importance (il y a une différence entre "`mon_theme`" et "`Mon_theme`"). Par sécurité, nous vous recommandons de n'utiliser que des minuscules pour être sur de ne pas avoir de problèmes par la suite.
- Modifiez les fichiers pour refléter le nom du thème
  Utilisez un éditeur de texte (pour cet exemple nous utiliserons notepad.exe), ouvrez `votre_repertoire_coppermine/themes/mon_theme/template.html`. Trouvez "`themes/classic`" et remplacez par "`themes/mon_theme`" (Il est possible de trouver la référence au nom de fichier plusieurs fois, assurez-vous donc que toutes les occurrences de "`themes/classic`" ont été remplacées par "`themes/mon_theme`"). Sauvegardez vos changements. Puis faites la même chose avec les fichiers `theme.php` et `style.css`.

Il est fortement recommandé de renommer votre thème personnalisé comme expliqué plus haut, même si vous ne voulez faire que de petites modifications au thème par défaut livré avec Coppermine. La raison en est très simple: lors des mises à jour plus tard, vous n'aurez pas de problèmes (par exemple de remplacement accidentel de votre thème personnalisé avec une mise à jour du thème par défaut).

## Trucs & astuces

Si vous n'êtes pas sur de la manière de créer votre propre thème, vous devriez jeter un œil à la section de téléchargement du site de Coppermine: il y a beaucoup de thèmes proposés en contribution par des utilisateurs disponibles au téléchargement et qui peuvent être visualisés sur la page de démonstration de Coppermine.

Pendant le processus de création ou de test d'un nouveau thème, vous ne voudrez peut être pas que celui ci soit disponible pour les visiteurs de votre site, mais vous (en tant qu'administrateur de votre galerie Coppermine) voudrez être en mesure de visualiser votre thème. Pour cela, ajoutez simplement `theme=nom_de_votre_theme` à l'URL dans votre navigateur.

- `http://votresite.com/coppermine/index.php?theme=nom_de_votre_theme` will show the coppermine index page, using your theme
- `http://votresite.com/coppermine/thumbnails.php?album=1&theme=nom_de_votre_theme` will show the thumbnail view of album 1, using your theme
- `http://votresite.com/coppermine/?theme=xxx` reviendra à l'affichage du thème que vous avez défini comme thème par default dans la configuration de Coppermine

## Utilisation d'éditeurs WYSIWYG

Il est fortement recommandé de ne pas utiliser d'éditeur WYSIWYG pour modifier les fichiers de Coppermine. L'équipe de développement de Coppermine est consciente que cela peut sembler plus facile pour les débutants d'utiliser ce genre d'éditeurs graphiques. Toutefois ils ont de gros inconvénients:

- Certains éditeurs (en particulier MS Frontpage) sont connus pour "améliorer" la présentation du code de sorte à rendre le code PHP inclus invalide. En conséquence, si vous utilisez un éditeur WYSIWYG pour modifier le fichier theme.php, le fichier peut être corrompu (c.à.d. inutilisable).
- Les éditeurs graphiques ont tendance à créer du code HTML propriétaire, déprécié et invalide. Vous aurez plus de contrôle si vous utilisez un simple éditeur de texte à la place.
- Vous n'apprendrez rien. Tôt ou tard, vous voudrez faire quelque chose que votre précieux éditeur WYSIWYG sera incapable de faire. Et alors ? Vous avez toujours utilisé cet éditeur pour faire votre travail - et vous ne comprenez rien au langage HTML. En utilisant un éditeur de texte, la courbe d'apprentissage sera raide, mais beaucoup plus intéressante.

Si vous ne savez par quel éditeur utiliser, jetez un œil à la liste des éditeurs sur la page outils recommandés par les développeurs.

## 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 code (pas de PHP !) Plus un certain nombre d'appels à des conteneurs qui seront remplacés par un contenu lorsque le thème est interprété (c.à.d. lorsque la sortie HTML des pages de la galerie est générée). Template.html détermine l'aspect général des pages de votre galerie. Utilisez le pour adapter l'aspect de a galerie à celui de votre site.

### Favicon

Coppermine est fournis avec un fichier favicon qui se trouve dans le répertoire racine de la galerie. Il y à une référence vers ce fichier dans tous les thèmes qui sont fournis avec Coppermine. Vous pouvez évidemment utiliser un fichier favicon de votre cru et changer la référence dans votre fichier thème personnalisé. Pour ce faire, ouvrez themes/votre_theme/template.html, trouvez `<link rel="shortcut icon" href="favicon.ico" />` et modifiez à votre convenance.

Comme alternative, vous pouvez aussi remplacer le fichier favicon du thème que vous utilisez par votre fichier favicon personnalisé.

## Changer les couleurs & le design

Pour modifier les couleurs, les polices, la taille des polices etc... Utilisées par le script, vous devrez modifier la feuille de style "style.css" dès que possible. Par exemple, si vous voulez augmenter ou diminuer la taille des polices d'écritures, modifiez simplement la ligne avec : `table { font-size: 12px; }`. La plupart des tailles des polices utilisées par le script sont définies comme un pourcentage de cette taille.

## Étapes avancées

Il y a des étapes plus avancées que vous pouvez suivre - elles sont décrites dans les sections

- Créer un thème pour Coppermine qui reprend l'aspect de l'ensemble de votre site
- Modifier theme.php