# 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éfabriqués:

- Classic
  Le thème par défaut avec un fond blanc et un menu horizontal.
- Eyeball
  Un thème avec un fond sombre et un menu horizontal qui s'étend pour que l'utilisateur dispose d'une meilleure intéraction.
- Fruity
  Un thème coloré avec menu vertical à gauche.
- 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.
- IGames
  Un thème sombre avec des effets 3D et un menu horizontal.
- Mac OX X
  Un thème clair avec un menu horizontal extensible qui ressemble à l'apparence d'un Mac.
- Project VII
  Un thème à fond blanc disposant d'un menu horizontal extensible.
- Rainy Day
  Un thème à fond sombre et bords arrondis.
- Sample
  Le thème Sample est identique au thème Classic. 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.

## 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 à partir 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), que d'une version majeure à l'autre, 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 package Coppermine n'ont pas besoin d'être mis à jour , comme 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.

En 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 ce 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 analisée , le code de base appelera des fonctions de theme. Si ces fonctions existent dans votre thèmes personnalisé, elles seront prises en compte. Si une fonction n'éxiste 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 peronnalisé prendra le pas sur les fonctions du thème de base.

## Etape suivante ?

Il existe, étape par étape, des instructions fournies dans la section "Création de votre thème personnalisé " que vous devriez lire pour plus de détails. Faites attention également aux sections qui traitent de la "Clause de non-responsabilité des droits d'auteurs dans le pied de page " et la section "Contenu dynamique (PHP-driven)".