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

# Thèmes

Coppermine est livré avec un moteur puissant qui vous permet de créer votre propre thème, en donnant à votre galerie un look unique qui correspond à la présentation de l'ensemble de votre site. D'autres applications les appellent "skins" ou "templates", nous les appelons "thèmes".

Il y a un nombre (en évolution constante) d'utilisateurs contribuant à la création de thèmes qui peuvent être visualisés et téléchargés à partir du site web de Coppermine.

## Les thèmes livrés avec Coppermine

Le package complet de Coppermine est livré avec plusieurs thèmes prèts à l'emploi:

### Curve

Thème avec un fond clair et un menu déroulant horizontal n'utilisant que le CSS. Nouveau thème par défaut pour cpg1.5.X inspiré du nouveau thème de SMF 2.0. Le menu de navigation ne repose pas sur du JavaScript, mais uniquement du CSS. Le thème curve est le thème le plus récent de Coppermine, donc le plus moderne. Il a une apparence simple, avec beaucoup de coins arrondis et devrait être harmonieux avec beaucoup de site existant sur fond clair. Les coins arrondis ne fonctionneront pas dans tous les navigateurs.
Le thème de la curve utilise actuellement des solutions de contournement pour s’afficher correctement dans Internet Explorer 6 et 7. Si cela vous gêne, c'est à dire si vous n'aimez pas l'application de hacks de navigateur et estimez ne devoir avoir que du code pur validé, vous êtes invités à supprimer ces hacks de navigateur.

#### IE6

Pour supprimer la compatibilité avec IE6,

- effacer `<!-- Begin IE6 support --> ... <!-- End IE6 support -->` dans `themes/curve/template.html`
- effacer le fichier `csshover3.htc` du dossier de votre thème (`themes/curve/`).

#### IE7

Pour supprimer la compatibilité avec IE7,

- effacer `<!-- Begin IE7 support --> ... <!-- End IE7 support -->` from `themes/curve/template.html`
- Enlever toutes les lignes avec `/* IE7 */` dans `themes/curve/style.css`,
- Enlevez les commentaires `/* min-height: 95px; */` dans `themes/curve/style.css` en les remplaçants par `min-height: 95px;`.

### Eyeball

Un thème avec un fond sombre et un menu horizontal qui s'étend pour que l'utilisateur dispose d'une meilleure interaction.

### Hardwired

Un thème avec un fond sombre et une petite taille de police qui fonctionne bien pour des espaces restreints et de petites résolutions. Conçu avec deux menus horizontaux.

### Rainy Day

Un thème à fond sombre et bords arrondis.

### Sample

Le thème Sample est identique au thème Waterdrop. Il n'apparaîtra pas dans la sélection des thèmes- il est conçu comme un modèle à copier pour la création ou la modification de votre propre thème.

### Waterdrop

Un thème à fond clair et un menu horizontal "conventionnel".

Les thèmes "Classic", "Fruity", "Igames", "Mac OX X" et "Project VII" qui existaient dans cpg1.4.x ont été effacés du pack de cpg1.5.x. Ils sont disponibles en téléchargement séparé référez-vous à la section thèmes provenant de contributions d'utilisateurs pour plus de détails.

## Mise à jour de votre thème personnalisé

Pour mettre un jour un thème personnalisé à partir cpg1.4.x vers la version 1.5.x, Lisez la documentation de mise à jour des thèmes.

Si vous mettez à jour cpg1.3.x vers cpg1.5.x, vous devrez procéder à la mise à jour en deux étapes: d'abord, vous devrez mettre à jour votre thème à partant de cpg1.3.x vers cpg1.4.x et ensuite de cpg1.4.x vers cpg1.5.x

Vous ne devez mettre à jour votre thème personnalisé que lors d'une mise à niveau majeure entre les versions (par exemple, de cpg1.3.x à cpg1.4.x ou de cpg1.4.x à cpg1.5.x), d'une version majeure à une autre, car le moteur de thèmes étant sujets à changements. Quand vous faites seulement une mise à niveau mineure (par exemple, de cpg1.5.x à cpg1.5.y), vous n'avez pas à mettre à jour votre thème personnalisé.

Les thèmes principaux livrés avec le paquetage de Coppermine n'ont pas besoin d'être mis à jour, puisqu’ils seront remplacés durant la mise à niveau, ils contiendront déjà tous les changements. Toutefois: si votre thème personnalisé est basé sur l'un des thèmes principaux (par exemple, le thème Classic), prêtez attention à d'éventuels changements. Comme suggéré ci-dessous, il est conseillé de renommer votre thème personnalisé afin de s'assurer qu'il n'est pas accidentellement écrasé lors de la mise à niveau.

## Contenu d'un thème

Les thèmes Coppermine sont stockés dans le répertoire "themes" chaque thèmes se composent de trois fichiers principaux :

- "template.html" le modèle principal en HTML.
- "style.css" la feuille de style associée au modèle.
- "theme.php" le fichier de thème en PHP.

AEn outre, il y a habituellement un dossier nommé "images" qui se trouve dans le dossier themes (themes/nom_du_thèmes/images/) qui contient les images utilisées pour le thème précis (logos, bullets, backgrounds et autres ressources graphiques nécessaires).

## Comment fonctionne le moteur de thèmes

Quand une page de Coppermine est analysée, le code de base appellera des fonctions de theme. Si ces fonctions existent dans votre thème personnalisé, elles seront prises en compte. Si une fonction n'existe pas dans votre thème personnalisé, la fonction de base sera utilisée. Les fonctions de base (Le comportement du thème par défaut si vous préférez) se trouvent dans `includes/themes.inc.php`.

Par conséquent, vous ne devez aucunement modifier `includes/themes.inc.php`, sans quoi vos modifications seraient perdues lors de prochaines mises à jour. Tout ce qui pourra être accompli par l'édition d'`include/themes.inc.php` peut être accompli par l'édition de `themes/votre_thème/theme.php` si bien que tout ce qui sera défini dans votre thème personnalisé prendra le pas sur les fonctions du thème de base.

## Et ensuite ?

Il existe, des instructions étape par étape, fournies dans la section "Création de votre thème personnalisé" que vous devriez lire pour plus de détails. Si vous êtes à la recherche d’exemple sur la façon de modifier votre thème personnalisé, vous devriez lire attentivement la page "Exemple de thèmes" car elle contient des solutions spectaculaire prêtent à être copier/coller pour votre thème personnalisé, en particulier dans la mesure ou votre thème est concerné par du contenu supplémentaire. Faites attention également aux sections qui traitent de la contenu supplémentaire. Faites attention également aux sections qui traitent de l'"Affichage des droits d'auteurs et clause de non responsabilité dans le pied de page" et à la section "Contenu dynamique (piloté par PHP)".