# 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:

- Curve
  Thème avec un fond clair et un menu déroulant horizontal n'utilisant que le CSS. Nouveau theme par défaut pour cpg1.5.X inspiré du nouveau thème de SMF 2.0.

  This theme currently uses workarounds to display correctly in Internet Explorer 6 and 7.
  To remove IE6 support,
  - delete <!-- Begin IE6 support --> ... <!-- End IE6 support --> from template.html
  - delete the file csshover3.htc from the theme folder.
  To remove support for IE7,
  - delete <!-- Begin IE7 support --> ... <!-- End IE7 support --> from template.html
  - remove all lines with /* IE7 */ from style.css,
  - uncomment the line /* min-height: 95px; */ in style.css.

- 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.
- 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ème provenants 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 à 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 (piloté par PHP)".