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

# Mise à Jour

Merci de prendre note: comme il y a eu des changements aussi bien dans le fichiers de Coppermine que dans la base de donnée des versions précédentes à cpg1.5.x, les utilisateurs de versions antérieurs à cpg1.5.0 doivent appliquer toutes les étapes mentionnées ci-dessous: les fichiers doivent être remplacée et le script update.php doit être éxécuté une fois.

## Pourquoi mettre à jour?

Il y à des versions majeurs et mineures de Coppermine. Les versions majeures ont été cpg1.0, cpg1.1, cpg1.2.x, cpg1.3.x et cpg1.4.x. La prochaine version majeure sera cpg1.5.x (Qui est actuellement en phase de développement - sans date de publication pour l'instant) - vous êtes juste en train de lire la documentation préliminaire pour cpg1.5.x. Les versions mineurs (représentée par le troisème chiffre dans le numéro de version) représentent les mises à jour, aussi connues sou sle nom de "versions de maintenance". Les versions majeurs contiennent de nouvelles fonctions (comparé à la dernière version majeure), les versions mineures ne contiennent pas de nouvelles fonctions, mais uniquement des corrections de bugs ainsiq eu de petites améliorations (comme de nouveaux fichiers langue).

Pour comprendre la politique de publication de versions de l'équipe de développement de Coppermine, vous devez comprendre comment les bugs sont corrigés: nous gérons un espace référenciel ou le code de chaque version majeure est constamment amélioré. Les bugs majeurs et mineurs qui sont rapportés sur le forum d'aide de Copperminesont corrigés dans ce référenciel. Chaque fois qu'un nouveau package est préparé, toutes les corrections qio ont été faites dans ce référenciel sont inclues dans la nouvelle version de mise à jour de maintenance.

Il y a une bonne raison pour chaque publication de version de maintenance: Elles sont généralement faites lorsqu'un nouveau bug ou vulnérabilité ayant un impact au niveau de la sécurité sont découverts. Comme expliqué plus haut, il y a plusieures corrections de bugs mineurs qui sont inclus dans chaque nouvelle mise à jour, pas uniquement la correction pour le bug majeur ou pourla vulnérabilité qui a nécessité la publication de la nouvelle version de maintenance. C'est pourquoi, ce n'est pas suffisant de juste corriger la faille qui à nécésité la publication de la mise à jour de maintenance.A la place, mettez toujours votre galerie à jour avec le version stable la plus récente dès qu'elle est publiée.

### Raisons de publication des packages

Voici une liste des versions mineures de cpg1.5.x et la raison pour laquelle elle à été publiée. Ceci pour vous expliquer pourquoi vous devriez mettre votre galerie à jour le plus rapidement possible vers la version stable la plus récente si vous utilisez une version plus ancienne.

Details

Package | Raison de la mise à jour | Date de publication
--- | --- | ---
cpg1.5.8 | Maintenance release (stable) Announcement thread Fixed setting default language with language manager (thread) Changed form token generation - removed trouble maker parameters (thread) Fixed language manager issue for language files with underscore (thread) Set moderator group to '0' for all albums to avoid problems for people who used that feature before it was dropped (thread) Fixed ecard if no intermediate picture is present (thread) Added Estonian language file (user contribution) Update 'last visit' time if it's a 'remember me' session (thread) Added Slovak language file (user contribution) While deleting non-images, delete the corresponding custom thumbnail if exists While renaming non-images, rename the corresponding custom thumbnail if exists While renaming files, check if there will be no conflicts before doing anything Added plugin hook 'token_criteria' Fixed missing CSS class cpg_summary and icon replacement leading to broken output of help boxes on config screen (thread & thread) Fixed possibility for users to edit their files in public galleries if disabled in config (thread) Disable the possibility for guests to enter file details by default (thread) Fixed error message when regular users try to delete their albums in public categories Re-organizing zip archives inside docs folder Adding documentation about plugin config options Fixed issue when reset file ratings (thread) Fixed empty values for 'reason' in 'report to administrator' email (thread) Fixed category view when albums with keywords are present (thread) Changed type of plugin hooks 'theme_thumbnails_wrapper_start/end' from 'filter' to 'action' and adjusted English documentation accordingly (thread) Added search terms to the title of the thumbnails page (thread) Added Japanese language file (user contribution) Adding boxes to config documentation for defaults, max, min, recomended and record name Display Coppermine news always in an iframe (thread) Fixed error message for non existing categories (thread) Replaced wrong link in update.php (thread) Added language table population section to update script to stop cpg1.4.x upgrades seing only Luxemburgish and Mexican as available langauges Updated Turkish language file (user contribution) Show password prompt if user tries to access file in password protected album directly Added Brazilian language file (user contribution) Fixed uploading to password protected albums in public categories (thread) Changed default values for user galleries category (thread) Fixed album visibility issue with user galleries (thread) Changed fix for category alpha sorting Fixed a critical error with the most viewed meta album Updated French language file (improvement and corrections) Allow higher port numbers for the site url config setting Fixed display of swf files in Firefox (thread) Fixed resizing of watermark backup images (thread) Fixed category permissions for secondary user groups (thread) Fixed issue when editing user albums (thread) Fixed issues with usergal_alphatabs plugin (thread & thread) Fixed line breaks in contact form emails Removed outdated FAQ items Updated Hungarian language file (user contribution) Fixed pre-population of user name on comments form (thread) Fixed timeout issue when fetching remote files (thread) Fixed thumb sharpening (thread) Place new comments form accordingly to sort order of comments (thread) Added Danish language file (user contribution) Added default value for 'user_profile6' during user creation (thread) Fixed HTML validation issue for german lang files - replaced & by &amp; Updated plugin manager documentation (thread) Added Hungarian language file (user contribution) Fixed pagination for user manager (thread) Updated Finnish language file (user contribution) | 2010-08-06
cpg1.5.7 | This package was never released. In fact it never existed. | -
cpg1.5.6 | Maintenance release (stable) Announcement thread Fixed broken link (thread) Extended lang_byte_units array for some language files (thread) Fixed ip address duplicates in stat_details.php (thread) Updated Czech language file (user contribution) Fixed typo that caused the display of the 'not supported version' message box (thread) Fixed issue when uploading plugins to Windows-driven galleries Removed cpg1.3.x theme upgrade guide, as a direct upgrade from cpg1.3.x to cpg1.5.x no longer is supported Create different log entries for user registrations and admin user creations in access log file (thread) Fixed config value for path to ImageMagick when selecting GD during intallation (thread) Fixed query for album moderation group (thread) Fixed display of upload approval button (thread) | 2010-06-04
cpg1.5.4 | Stable release Announcement thread | 2010-06-02
cpg1.5.3 | Release candidate Announcement thread | 2010-03-05
cpg1.5.2 | Version BétaBeta release. Première publication publique pour tests et évalusation. Ne pas utiliser en production! Pas de support d'aide actuellement. Sujet d'annonce | 2009-11-16
cpg1.5.1 | Vesion Alpha release pour les testeurs et les traducteurs. Cette version n'est pas une version publique. Elle à seulement été mise à disposition pour un groupe restreint d'utilisateurs pour des tests et pour permettre la traduction. | Pas publiée à ce jour
cpg1.5.0 | Cette version n'a jamais été publiée sous forme de package - Le numéro de version 1.5.0 a juste été réservé pour la phase initiale de développement de la série cpg1.5.x avant le début de la période de gel des modifications. Il n'y a pas de packs disponible, et il n'y en a jamais eu - seule une récupération par Subversion est possible. | jamais

Comme vous pouvez le voir, l'équipe de développement de Coppermine est constamment en train de corriger et d'améliorer le script. Chaque élément de logiciel non banal contient des bugs, il est donc non garanti que la version qui actuellement est la plus récente sera la dernière, entièrement vierge de bugs qui sera publiée dans la série cpg1.5.x. Il est absolument vital que vous fassiez une mise à jour aussitôt qu'un nouveau pack est mis à disposition.

### Changelog

Le détail des changements qui sont intervenus dans une nouvelle version peuvent être trouvés dans le fichier "changelog" qui se trouve dans chaque pack. Le fichier "changelog" se trouve dans le réeprtoire racine du pack de Coppermine. Le fichier "changelog" contient plus d'informations sur les langues supplémentaires et la date de la correction.

Le fichier "changelog" est un fichier texte qui peut être lu par un simple éditeur de texte - sur une machine utilisant windows, notepad.exe convient parfaitement.

## Etapes nécessaires lors de la mise à jour de Coppermine (depuis n'importe quelle version)

- Téléchargez la version stable la plus récente disponible dans le section de téléchargement de la page d'accueil officielle de Coppermine
  Ne pensez pas que vous avez la version la plus récente, particulièrement si vous avez installé Coppermine à l'aide d'un panneau de controle mis à disposition par votre hébergeur. L'équipe de développement de Coppermine ne recommande pas l'utilisation des auto-installeurs - Merci de télécharger les fichiers originaux depuis le site officiel de Coppermine.
- Faites une sauvegarde (dump) de votre base de donnée
  (Les outils recommandés pour une sauvegarde de la base de donnée sont mySqlDumper ou phpMyAdmin - Regardez la section Outils recommandés par les développeurs: Manipulation de base de donnée pour plus de détails).
  La création d'une sauvegarde n'est pas obligatoire en terme de fonctionnalités, mais juste une précaution au cas où les choses se passeraient mal. Il est recommandé de faire des sauvegardes fréquentes de toutes manières.
- Sauvegardez vos fichiers "include/config.inc.php", "anycontent.php" et de votre répertoire "albums" en précaution dans le cas où quelque chose se passerait mal.
  En général, téléchargez simplement le répertoire entier de Coppermine sur votre disque dur local ou sur n'importe quel emplacement de sauvegarde sûr, en utilisant votre application FTP. Un nouveau pack de Coppermine ne contient jamais de fichier de configuration (Ce fichier est crée lors de l'installation sur votre serveur), vous ne pourez donc pas remplacer un fichier de configuration existant par un fichier vide provenant du pack; néanmoins, encore une fois, la sauvegarde est faite pour plus de sureté.
- Décompressez le pack de Coppermine que vous avez téléchargé dans un répertoire temporaire de votre disque dur local (en préservant la structure des dossiers contenus dans le pack)
- A l'exeption du répertoire "albums", téléchargez tous les nouveaux fichiers et répertoires, en vous assurant de ne pas remplacer votre fichier "anycontent.php" ou du répertoire albums.
  En fait, vous pouvez télécharger aussi le répertoire albums - Celui contenu dans le pack est vide lui aussi. La recommandation de ne pas télécharger ce répertoire est une précaution pour certains utilisateurs qui ont une configuration "bizaroïde" pour leur application FTP: certaine application FTP "exotiques effacent les dossiers existants sur le serveur et les remplacent par des dossiers vides. Ce serait bien entendu un désastre, vous perdriez ainsi tous les fichiers quei vous aviez téléchargé dans votre galerie. Néanmoins, le nombre d'applications FTP qui sont paramétrées de cette manière étrange sont très rares, celà ne posera pas de problèmes de télécharger aussi le répertoire albums pour la majorité d'entre vous. Si vous n'êtes pas sur, utilisez une des applications FTP recommandées par les développeurs.
- Lancez le fichier "update.php" dans le répertoire Coppermine depuis votre navigateur (exemple. `http://votresite.com/votre_repertoire_coppermine/update.php`).
  Celà mettra à jour votre installation Coppermine en faisant tous les changements nécessaires dans la base de donnée.
- Si vous avez crée un thème personnalisé, appliquez les changements introduits dans la structure des thèmes à votre thème personnalisé
  Voyez le guide de mise à jour des thèmes pour plus de détails.

Pour être tout à fait clair:

Il n'y a pas de pack séparé pour les mises à jour - Coppermine est toujours publié comme un pack complet qui peut être utilisé aussi bien pour une nouvelle installation que pour une mise à jour.

## Action supplémentaires pour la mise à jour depuis une versio particulière

En fonction de la version depuis laquelle vous faites une mise à jour, il y a des actions supplémentaires à réaliser:

### Mise à jour depuis une version cpg1.0, cpg1.1, cpg1.2.x ou cpg1.3.x vers cpg1.5.x

La possibilité de mettre directement à jour depuis cpg1.0, cpg1.1, cpg1.2.x ou cpg1.3.x vers cpg1.5.x a été supprimée - si vous utilisez une aussi ancienne version, vous devrez faire votre mise à jour en deux temps (de votre version vers cpg1.4.x puis vers cpg1.5.x)

### Mise à jour depuis cpg1.4.x vers cpg1.5.x

- Les plugins écrits pour cpg1.4.x ne peuvent généralement pas être utilisés avec cpg1.5.x, vous devez donc les désactiver tant que vous êtes encore sous cpg1.4.x (avant de commencer la mise à jour). Certaines fonctions qui étaient sous forme de plugin dans cpg1.4.x ont été inclues dans le coeur de cpg1.5.x, vous n'aurez donc plus besoin de ces plugins. La manière la plus sure pour les plugins n'interfèrent pas, est de désactiver tous les plugins en utilisant l'option correspondante de la configuration, pusi d'effacer le contenu du répertore plugins ave votre clien FTP. Après la mise à jour, cherchez les versions crées pour cpg1.5.x et téléchargez les, puis réactivez le plugins un à un.
- Le mécanisme de bridge à changé de cpg1.4.x à cpg1.5.x, il est donc conseillé de temporairement dé-bridger votre galerie tant qu'elle fonctionne sous cpg1.4.x (assurez vous de bien vous rappeler des données de votre compte administrateur pour une galerie non bridgée - vous n aurez besoin). Après la mise à jour vers cpg1.5.x, vous pourrez réactiver le bridge à nouveau.
- Si vous avez crée un theme personnalisé, appliquez les changements qui ont été introduits dans la structure des thèmes à votre thème personnalisé - regardez le guide de mise à jour des thèmes.
- Vous ne pouvez pas utiliser de fchier langue d'une ancienne version de Coppermine comme langue primaire (La langue que l'administrateur va utiliser) - assurez vous de n'avoir que les fichiers langues qui se trouvent dans le package de Coppermine, dans votre répertoire "lang" (effacez ou renommez les fichiers provenant d'anciennes versions se trouvant dans votre répertoire "lang").
  Si vous souhaitez utiliser une langue qui n'a pas été traduite pour cpg1.5.x, vous pouvez essayer d'utiliser le fichier langue de cpg1.4.x, néanmoins il y a certaine mises en garde:
  - les phrase de cpg1.5.x qui n'existent pas dans votre ancien fichier langue ne seront pas traduits ou affichés en Anglais
  - L'administration de Coppermine ne peut pas se faire en utilisant un ancien fichier langue - l'administration nécessite un "vrai" fichier langue de la version cpg1.5.x
  - Vous êtes libres d'essayer d'anciens fichiers langue, toutefois, si vosu rencontre des problèmes ou avez des messages d'erreur, passez à la langue US-English et regardez si ces problèmes disparaissent. Il n'y aura pas d'aide pour l'utilisation d'anciens fichiers langue
- Dans Cpg1.3.x, les mots de passe des utilisateurs étaient stockés en clair dans la base de donnée. Celà à changé avec cpg1.4.x - de basen, cpg1.4.x crypte les mots de passe stockés. Néanmoins, il y avait une option pour ceux qui faisaient une mise à jour de cpg1.3.x vers cpg1.4.x qui permettait de sauter l'étape du cryptage des mots de passe. Dans cpg1.5.x, le stockage de mots de passe en calir n'est plus une option. Si vous êtes en train d'utiliser une ancienne galerie qui a d'abbord été mise à jour depuis cpg1.3.x vers cpg1.4.x et maintenant vers cpg1.5.x, le script de mise à jour cryptera automatiquement les mots de passe de vos utilisateurs (Y compris votre compte administrateur). Vous n'avez pas à vous préoccuper de quoi que ce soit, le script de mise à jour fera celà automatiquement.
- L'option d'affichage d'une FAQ pour les utilisateurs finaux (en sélectionnant l'option de configuration correspondante) qui existait avec cpg1.3.x et cpg1.4.x a été supprimée dans cpg1.5.x, parcequ'elle n'était pas utilisée et qu'elle ne faisait qu'ajouter une charge de travail supplémentaire aux traducteurs. Si vous êtes de ces quelques utilisateurs qui actuellement utilisent l'élément de menu FAQ dans le menu de navigation de Coppermine, vous pourez facilement créer une page personalisée qui utilise le haut de page te le pied de page de Coppermine pour afficher votre propre FAQ.

- Effacez les fichier obsolètes venant des anciennes versions de Coppermine et qui n'existent plus dans cpg1.5.x.
  La aussi, c'est juste une précaution pour s'assurer que votre nouvelle galerie ne contienne plus de failles de sécurités provenant d'anciennes versions et qui permettraient à des personnes malveillantes d'utiliser ces faiblesses d'anciennes versions. Pour trouver quels fichiers doivent être effacés manuellement, regardez l'affichage en bas de page de l'écran de mise à jour (`http://votresite.com/votre_repertoire_coppermine/update.php`) - Le script de mise à jour va essayer d'effacer ces fichiers pour vous, mais dans la plupart des configurations serveurs, il n'aura pas les autorisations pour le faire, et vous devrez donc les effacer manuellement vous même en utilisant votre client FTP. Une autre manière de trouver quels fichiers sont à éffacer est la page de vérification de version - les fichiers qui sont programmés pour un effacement sont affichés là aussi - la page de vérification de version n'essayera pas d'effacer ces fichiers.
- Si votre serveur tourne avec le "safe_mode" et que vous avez activé "SILLY_SAFE_MODE" dans include/config.inc.php, vous devrez aller dans la configuration de Coppermine après avoir fait toutes les étapes mentionnées ci dessus l'activation "silly safe mode" , comme paramètre dans `include/config.inc.php` n'est plus pris en compte par cpg1.5.x. Le paramétrage du "silly_safe_mode" à été remplacé par un paramètre de configuration.
- URI upload removed
  The URI upload feature has been removed from cpg1.4.x to cpg1.5.x, as it wasn't actually doing what many users thought that it would do: when using URI uploads people expected the file to remain at the URI that they entered into the upload form and not be transfered to the webspace where their Coppermine gallery resided on. Subsequently, they thought that they could safe webspace. This was a misconception and in fact just wishfull thinking: using URI uploads in cpg1.4.x, the file actually was uploaded to the Coppermine webspace no matter what.
  Therefore, the actual feature "URI upload" was removed in cpg1.5.x. However (depending on the operating system of your client) you can (ab)use the regular http upload form to accomplish a similar thing in cpg1.5.x: when entering the URL of a file accepted by Coppermine into the http upload form, the file will get downloaded to your client's temporary folder and then a regular http upload from your client to your server will be performed. This is not actually a feature built into coppermine, but rather a feature of your OS/browser and therefore it goes unsupported. However, there is no action required when performing the upgrade - this paragraph is just meant to inform you that the feature was dropped.

- #### Configure new features

  In comparison to cpg1.4.x, the new version cpg1.5.x comes with a load of new features. Some of them are enabled by default after performing the upgrade, which might not be what you want. Therefore, it's advisable that you (at least cursorily) read up the features list and check the config panel and the groups control panel for the changes there. The way that Coppermine handles languages has been changed as well, that's why you need to visit the language manager at least once after the upgrade and configure language support there.

## Le script de mise à jour de la base de donnée

Le script de mise à jour va mettre à jour votre base de donnée et effacer les fichiers laissés par les anciennes versions qui ne sont plus nécessaires par votre version. Il est accessible en cliquant sur le lien correspondant dans le menu administrateur ou en entrant l'URL dans la barre d'adresse de votre navigateur.

Vou spouvez lancer le script de mise à jour en entrant `http://votresite.com/votre_repertoire_copperminer/update.php` dans la barre d'adresse de votre navigateur.

### Ce qu'il fait

Le script de mise à jour fait trois choses:

- Il vérifie les autorisations du visiteur qui accède au script
- Il lance les requêtes de la base de donnée mysql qui se trouvent dans le fichier `sql/update.sql` (en remplacant le préfixe de table générique par celui que vous avez défini pendant l'installation initiale)
- Il efface certains fichiers qui étaient présent dans le corps de Coppermine dans les versions antérieures. Le script n'efface que les fichiers inutiles, mais ne touche pas à vos fichiers personnalisés, il n'y a donc pas de raison de s'inquiéter.

### Objectif

Le script de mise à jour va mettre à jour la base de donnéeaprès que vous ayez remplacé manuellement le fichier sql qu'il utilise. Le script ne va pas détecter pour vous si il y a une nouvelle version de Coppermine disponible, ni ne va télécharger quoi que ce soit depuis le site de Coppermine. Le niveau d'automatisation n'est pas aussi avancé dans Coppermine (pour le moment).

Pour savoir si il y a de nouvelles versions de sécurité ou de maintenance de Coppermine, vérifiez les news de coppermine-gallery.net.

### Vérification des autorisations

Dans Coppermine, avant cpg1.5.x, le script de mise à jour utilisé était accessible par tout le monde, c.a.d. tout le monde était en mesure de le lancer. Si c'était pratique pour l'aide (les supporters pouvaient lancer le script pour les utilisateurs qui demandaient de l'aide si il s'avérait qu'ils avaient oublié de le lancer), il y avait une petite possibilité que cette accessibilité pour tout le monde pose un risque de sécurité à un moment donné. C'est pourquoi l'équipe de développement de Coppermine a décidé de protéger le script de mise à jour afin qu'un visiteur ne puisse pas le lancer ni y accéder - A partir de cpg1.5x vous devez avoir des droit d'administrateur pour y accéder. Celà peut ce faire de 4 manières différentes:

- Si vous êtes déjà identifiés comme administrateur et que vous lacez le script de mise à jour depuis le lien du menu administrateur de Coppermine, le script devrait s'éxecuter sans vous demander de vous autentifier - il utilise l'autentification "régulière" par cookie utilisée par l'ensemble de Coppermine
- Si vous nêtes pas identifiés comme administrateur ou si les composants de Coppermine ne fonctionnent plus sans avoir lancé le script de mise à jour auparavant (généralement lors de la mise à jour vers une version majeure de Coppermine), Vous devrez vous autentifier - entrez les éléments de votre compte administrateur de Coppermine tesl que vous les avez définis lors de l'installation initiale de Coppermine
- Si vous ne vous rappelez pas de vos identifiants administrateur Coppermine (pour une version autonome), vous pouvez entrer vos identifiants mysql - vous aviez besoin d'eux lors de l'installation initiale de Coppermine. Si vous les avez oubliés, trouvez les dans le fichier utilisé pour stocker les données de connection à la base de donnée mysql: téléchargez `include/config.inc.php` depuis votre serveur vers votre ordinateur puis ouvrez le fichier avec un simple éditeur de texte - vous devriez trouver vos identifiants mysql dans ce fichier. Si ils ont changés, votrehébergeur devrait être en mesure de vous aider à les retrouver.
- Si tout celà ne devait pas fonctionner, il y a un inverseur dans le code du script de mise à jour qui peut être utilisé pour passer l'étaper de l'autentification - pour changer cet inverseur, téléchargez le script de mise à jour (`update.php`) depuis votre serveur sur votre ordinateur, trouvez `// define('SKIP_AUTHENTICATION', true);` et remplacez le par `define('SKIP_AUTHENTICATION', true);`. Savegardez vos changements et placez le fichier modifié sur votre serveur, en remplacant celui existant. N'oubliez pas de restaurer le paramétrage après avoir fait la mise à jour avec succès.

### Quand faut-il lancer le script de mise à jour?

Vous devez lancer le script de mise à jour à chaque fois que vous mettez votre galerie à jour, c.a.d. à chaque fois que le fichier `sql/update.sql` est remplacé par une nouvelle version.

Celà ne pose pas de problèmes de lancer le script de mise à jour plusieurs fois de suite. Donc si vous avez un doute, lancez le à nouveau.

## L'outil de vérification de version

Depuis la publication de cpg1.3.2 Coppermine dispose d'un outil complémentaire de vérification de version pour vous aider à résoudre les problèmes lors des mises à jour facilement. Pour lancer le vérificateur de version, ajoutez simplement `versioncheck.php` dans la barre d'adresse de votre navigateur après vous être identifié en tant qu'administrateur dans votre galerie Coppermine (exemple: `http://votresite.com/votre_repertoire_coppermine/versioncheck.php`). avec la version 1.5.x, vous pouvez lancer l'utilitaire de vérification de version depuis le menu administrateur.

L'outil de vérification de version ne fait pas de mise à jour: il ne télécharge pas la nouvelle version de Coppermine pour vous ni n'installe aucune corrections - il est juste là pour vous rendre attentif aux nouvelles versions et à vous aider à vérifier si la mise à jour s'est bien passée.

### Qu'est ce qu'il fait

Le script de "vérification de version" est fait pour deux choses:

- Si vous mettez à jour depuis une version précédente, vous devriez lancer le script de vérification de version pour oir si la mise à jour a été faite avec succès
- Utilisez le vérificateur de version pour vous assurer que votre version de Coppermine est à jour

Le script passe en revue les fichiers de votre serveur web et essaye de vérifier si la version de votre fichier local sur votre serveur est la même que celle du référentiel de http://coppermine-gallery.net. Les fichiers qui ne sont pas identiques sont affichés et sont les fichiers que vous devriez mettre à jour.

En comparaison des versions précédentes, la page de vérification de version à été refaite pour cpg1.5.x aussi bien visuellement qu'en matière de fonctionnalités.

### Première utilisation

Lors du premier lancement du vérificateur de version vous verrez la page d'options en premier. Pour commencer, les options par défaut devraient être OK, soumettez donc juste le formulaire. Le script va ensuite déterminer la version de Coppermine que vous utilisez actuellement, et essayer de trouver le fichier XML sur le référentiel de Coppermine qui correspond à votre version. Si il y arriven il va comparer tous les fichiers qui existent sur votre serveur avec les fichiers les plus récents recommendés (en essayant d'obtenir les données depuis le référentiel). Par conscéquent, vous devriez voir une liste de répertoires et de fichiers qui sont supposés exister sur votre serveur ainsi qu'une explication si la version de vos fichiers est la plus récente. Pour plus de détails sur l'interpretation de cet affichagen continuez la lecture.

### Options

Il y a un petit nombre d'options disponibles sur la page de vérification de version qui devraient ^s'expliquer très facilement par elles même:

- #### Afficher la sortie

  Détermine si l'affichage doit être complêt ou uniquement sous format texte
  - Plein écran
    Utilisez là par défaut. Celà va afficher le plus de détails possible et à un aspect plus agréable
  - Texte-uniquement
    Si un vous demande de poster la sortie du verificateur de versions, basculez sur cette option, vous pourrez ainsi plus facilement copier/coller l'affichage à votre post sur le forum d'aide de Coppermine. Ne le faites que si un supporter vous le demande explicitement! Une autre raison potentielle d'utiliser la sortie texte uniquement est la consomation de ressources: Si vous obtenez des "time-outs", essayez d'utiliser l'option d'affichage texte uniquement, il consomme relativement moins de ressources.

- #### Montrer uniquement les erreus potentielles

  Si vous n'avez aucune idée de ce que cette sortie est supposée signifier, ou si un supporter vous le demande, vous devrez sélectionner cette option pour afficher uniquement les dossiers/fichiers qui ont des problèmes.

- #### Cacher les images

  En sélectionnant cette option, les nombreuses ressources graphiques qui font partie de Coppermine (exemple. toutes les icones et autres images) ne sont pas prises en compte dans l'affichage du vérificateur de version - un filtre est appliqué. Utilisez cette option pour rentre la sortie moins encombrée: les images ne sont généralement pas dés élément ssensibles à la sécurité, donc, si vous n'êtes interressé que par les fichiers qui ont un impact de sécurité, vou spouvez sans craintes cacher les images.

- #### Ne pas vérifier les fichiers modifiés

  Ce filtre cache la colonne "modifié", il en résulte un affichage légèrement moins encombré. La vérification des fichiers modifiés n esera pas faite lorsque le script est lancé. N'utilisez cette option que si vous avez des problèmes de performances avec le script ou si tous les fichiers sont affichés comme modifiés.

- #### Ne pas se connecter au référentiel en ligne

  Si vous sélectionnez cette option, le vérificateur de version n'essayera pas de se connecter au référentiel en ligne et utilisera le fichier XML local à la place. N'utilisez cette option que si la connection au référentiel en ligne ne fonctionne pas pour vous (par exemple si vous êtes sur un intranet et que votre serveur n'a pas d'accès internet). L'inconvénient le plus important de la non connection au référentiel en ligne est le fait que vous n'aurez aucune information quand à la necessité d'une mise à jour ni sur la dernière version disponible, essayez donc plutôt de trouver la raison pour laquelle vous ne pouvez pas vous connecter au référentiel en ligne.
  Pendant la période de développement, (entre les publications), le référentiel en ligne n'est pas souvent mis à jour, donc, si vous utilisez la vérification par SVN (par exemple si vous êtes développeur), vous pouvez sélectionner cette option.

L'écran d'options vous permets de configurer le vérificateur de version, ou plutôt ce qui est affiché. Ces options ne sont pas sauvegardées, vous devrez donc les ajuster à chaque fois que vous utiliserez le vérificateur de version. Les options par défaut devraient correspondre pour la plupart des utilisateurs - ne les changez que si voue avez une bonne raison de le faire.

### Comparaison de Version

Il y a beaucoup d'informations placées dans un très petit espace. Voici un exemple de sortie possible et ce que cette sortie signifie:

- #### Chemin

  Le nom du répertoire et du fichier

- #### Manquant

  Si rien n'est affiché dans cette colonne, le répertoire/fichier existe sur votre serveur. Si ce n'est pas le cas (par exemple que le répertoire/fichier n'existe pas sur le serveur ou est innacessible), la colonne "Manquant" sera remplie par le résultat de cette première et basique vérification.
  Note: il y a certains répertoires/fichiers qui sont obligatoires; d'autres sont optionnels. Néanmoins, si vous faites une nouvelle installation ou mise à jour, vous devez vous assurer de télécharger tous les répertoires/fichiers. Vous pourez ensuite effacer certains fichiers optionnels si vous le souhaitez, même si celà ne libèrera pas beaucoup d'espace serveur.
  Si un fichier est manquant, les autres étapes qui viennent à la suite de la vérification ne sont pas effectuées - un fichier manquant ne peut pas avoir de numéron de version ou quoi que ce soit d'autre. Si le vérificateur de version signale des fichiers manquants, utilisez fotre client FTP pour voir si ils sont effectivement manquants ou innaccessibles. Si ils sont manquants, re-téléchargez les. Si ils sont innacessibles, vous devrez leur donner les permissions nécessaires.
  Certains fichiers qui existaient dans les anciennes versions doivent être supprimés plus tard. Ceux qui peuvent avoir un problème de sécurité sont affichés avec le mot "effacé" dans la colonne "manquant". Si vous voyez de tels fichiers, utilisez votre client FTP pour effacer les fichiers que le vérificateur de version vous signale. Laisser les fichiers là ou ils sont, (en ignorant les suggestions données par le vérificateur de version) pose un problème de sécurité et n'est donc pas recommandé.

- #### Permissions

  Affiche les permissions assignées au répertoire/fichier. Pour certains fichiers, les droits en écriture sont nécessaires, alors que pour d'autres les droits en lecture sont suffisants. Si le niveaude permissions pour un répertoire est bon, le résultat sera affiché à côté avec une remarque (entre parenthèses)comme "OK" (celà peut êtr edifférent suivant les langues). Utiliser un script comme le vérificateur de version pour vérifier les droits sur les répertoires fonctionne bien, mais peut ou ne peut pas fonctionner très bien pour les fichiers. Celà dit, vous serez vraisemblablement concernés par des répertoires qui n'ont pas les bonnes permissions. Si un fichier devait être signalé comme n'ayant pas les bonnes permissions, ne vous alarmez pas si le reste de votre galerie fonctionne correctement.
  Si des droits pour des répertoires doivent être revus, lisez la section de la documentation concernant les permissions et faites ce qui y est expliqué.

- #### Version

  La version du fichier sur votre serveur. Si elle est identique à celle indiquée sur le référentiel, vous devriez voir un "OK". Si vous utilisez une ancienne version sur votre serveur, vous devrez vous procurer un nouveau package et faire une mise à jour.
  Note: Les répertoires n'ont pas de numéro de version, ni les fichiers binaires (comme les fichiers graphiques) n'en ont, c'est pourquoi la colonne "Version" affiche "n/a" pour les répertoires et le fichiers binaires. Seuls les fichiers contenant du texte peuvent avoir un numéro de version, ne vous alarmez pas pour les nombreux messages "n/a (OK)".

- #### Révision

  La révision du fichier sur votre serveur. Si elle est identique à celle indiquée dans le fichier XML du référentiel, vous devriez voir un "OK". Si vous utilisez une ancienne version sur votre serveur, vous devrez vous procurer un nouveau package et faire un emise à jour.
  La révision est relative à la version - habituellement, si votre version est bonne, votre révision devrait l'être aussi. La révision n'a de sens que si vous faites les mises à jour depuis le référentiel subversion .
  Ce qui s'applique au numero de version s'applique aussi aux révisions: seuls les fichiers texte peuvent avoir un numéro de révision - les répertoires et les fichiers binaires n'ont pas de numéro de révision.
  Perdu? il n'y a pas de raison: habituellement vous pouvez ignorer sans crainte les révisions - si vou svoulez savoir à quoi servent les révisions, lisez les détails sur la page concernant subversion .

- #### Modifié

  Si un fichier est accessible et que le numéro de version et de révision correspond, le vérificateur de version essaye de vérifier si le fichier à été modifié par rapport au fichier du pack originel. Cette vérification est faite au travers des "MD5-hashes" du fichier original et de votre copie.
  Lors d'une nouvelle installation ou mise à jour, il ne devrait pas y avoir de fichiers modifiés. Si ils sont affichés comme modifiés il peut y avoir plusieurs raisons:
  - Vous avez délibérément modifié le fichier (par exemple en lui appliquant une modification personnalisée). Dans ce cas, c'est normal et vous pouvez ignorer l'alerte dans la colonne "Modifié"-et continuer
  - Votre fichier n'a pas été entièrement transféré sur le serveur. Si c'est le cas, essayez de le re-télécharger depuis votre ordinateur vers votre serveur. Si ça ne vous aide pas, votre package à peut être été corrompu. Re-téléchargez en un depuis la section de téléchargement du site de Coppermine, décompressez le et retéléchargez le fichier sur le serveur. Assurez vous que votre client FTP est bien configurer pour remplacer les fichiers existants
  - Vous avez utilisé un mauvais mode FTP pour transférer le fichier sur votre serveur. Utilisez un client FTP vous permettant de transférer les fichiers en mode binaire ou ASCII. La plupart des clients FTP actuels ont une fonction qui sélectionne automatiquement le bon mode FTP pour chaque fichier. Si ce n'est pas le casn essayez une approche manuelle et spécifiez explicitement le mode FTP pour les fichiers que vous téléchargez.
  - Votre hébergeur injecte un code dans chaque fichier. Beaucoup d'hébergeurs gratuits font cet injection de publicité dans vos fichiers. Il n'y à pas grand chose à faire si ce n'est de prendre un hébergement payant ou d'ignorer l'alerte "Modifié" et espérer que tout fonctionne correctement.
  L'affichage de la colonne "modifié" peut être filtré avec l'option Ne pas vérifier les fichiers modifiés. Il en résultera une légère amélioration des performances du script de vérification de version.

- #### Commentaires

  La colonne commentaires contient une courte explication de ce qui est supposé ne pas être correct et de ce que vous pouvez faire pour le corriger. Pas de commentaires signifie habituellement que tout est correct.

- #### Lien vers le référentiel

  Le lien vers le référentiel SVN (web SVN) est présent comme une fonction complémentaire pour les utilisateurs très expérimentés et les développeurs. Lisez les instructions concernant le référentiel subversion pour en savoir plus. Si tou est correct, vous n'avez pas besoin de ce lien de toute façon.

### Choses pouvant mal se passer avec le vérificateur de version

Comme les actions réalisés par le vérificateur de version sont complexes, il y a plusieures choses qui peuvent mal se passer, en fonction de la configuration de votre serveur:

- Pas de connection avec le référentiel XML en ligne
  Si votre serveur se trouve derrière un proxy ou un filtre web necessitant une autentification, ou si vous n'avez pas de connection internet (par exemple un intranet d'entreprise), le script de vérification de version n'est pas capable de se connecter au référentiel XML en ligne. Utilisez les différentes options pour empecher le script d'essayer. Les mises en garde mentionnées dans les options s'appliquent à ce cas.
- J'ai une page blanche ou une page sans contenu
  Le script se heurte probablement à un times out, parce qu'il utilise énormément de ressources. Vous devrez vivre sans vérificateur de versions à cause de la configuration de votr eserveur, sauf si vous pouvez configurer vous même votre serveur, vous pourrez assigner plus de mémoire et de temps d'execution au script.
- J'ai un message d'erreur
  Un message d'erreur comme `Fatal error: Maximum execution time of 60 seconds exceeded in /path/to/webroot/coppermine_folder/include/versioncheck.inc.php on line 276` est l'indication ue le script consomme trop de ressources serveur. Essayez de désactiver certaines options. Si ça n'aide pas, ou ne pourrez pas utiliser le script de vérification de versio sur votre serveur.

Le vérificateur de version est mise à disposition gratuitement pour les utilisateurs finaux. Comme il y a beaucoup de facteurs qui ont un impact sur lui, il peut ou ne peut pas fonctionner sur votre configuration de serveur. Si l'outil de vérification de version ne fait rien du tout, c'est probablement le cas pour vous - ne vous alarmez pas : asurez vous juste que votre installation de Coppermine est à jour en activant l'option de configuration "Affichez les news de coppermine-gallery.net". Vous devriez vous alarmer et regarder de plus près uniquement si des problèmes individuels sont rapportés par l'outil de vérification de version (par exemple uniquement si certaines lignes contiennent des remarques dans la colonne commentaires).

### Fausse attente

Pour certains celà peut paraitre banal, pour d'autres un élément d'information particulièrement important: naturellement, les fichiers qui n'ont pas été remplacés lors de la mise à jour (exemple `anycontent.php`) apparaitront comme anciens dans la sortie du vérificateur de version. C'est bien entendu normal. Celà ne pose pas de problèmes si vous faites la mise à jour exactement comme expliqué, comme les fichiers que vous êtes supposés garder pendant le procesus de mise à jour ne contiennent pas de code nécessitant d'être mis à jour. Par exemple, `anycontent.php` ne contient aucun code actuellement (celui qui se trouve dans le packages de Coppermine). il peut contenir du code personnalisé que vous avez décidé d'utiliser. Pour plus de détails sur l'utilisation de `anycontent.php`, regardez la section "Utilisation d'anycontent.php".

## FAQ de mise à jour

- ### Comment trouver des informations sur les nouvelles mises à jour de Coppermine?

  Il y a plusieurs outils qui vous permettent de rester à jour et d'être sur de ne manque aucune mise à jour:
  - Laissez le paramétrage de la configuration de "Affichage des news de Coppermine-gallery.net" activé: cette fonction vous informera des nouvelles concernant les publications de nouvelles mises à jour et de problèmes de sécurité sur votr egalerie Coppermine. Les nouvelles ne sont visibles que par vous comme administrateur, les visiteurs ne les verront donc pas.
  - Souscrivez pour le package sur le site sf.net project
  - Inscrivez vous au forum d'annonces (en cliquant sur "notify" en étant identifié). Vous recevrez alors un courriel à chaque fois qu'un nouveau post sera fait sur le forum d'annonces.

- ### Quelle est la différence entre mise à jour et évolution?

  Les mots "mise à jour" et "évolution" sont souvent utilisés comme synonymes. Il y à un elégère différence dans la définition pour les développeurs de Coppermine: Améliorer signifie généralement l'augmentation du numéro de version majeur par exemple de cpg1.4.x vers cpg1.5.x; alors que mise à jour se réfère à une augmentation mineure du numéro de version, par exemple mise à jour de maintenance de cpg1.5.x vers cpg1.5.y.

## Retour de cpg1.5.x vers une version plus ancienne

CPG1.5.x inclue beaucoups de nouvelles fonctions (comparativement aux versions anciennes), nous encouragons donc tous les utilisateurs à évoluer vers cette nouvelle version. Néanmoins, certains voudront tester cpg1.5.x et décideront plus tard de vouloir revenir à une ancienne version. Vous devez garder à l'esprit qu'une mise à jour complete cange entièrement l'aspect de la base de donnée de Coppermine incluant la convertion de l'encodage vers l'unicode. Ce processus ne peut pas être annulé: une fois que cette convertion a été faite, la seule manière de revenir en arrière est de faire une restauratio complète de la base de donnée (bien entendu vous devrez créer cette sauvegarde avant que vousne commenciez la mise à jour). La création de sauvegardes de la base de donnée MySQL est recommandée de toute manière, vous deviez le faire maintenant.

Pour que ce soit très clair: vous ne pourrez revenir en arrière que si vous avez fait une mise à jour depuis Cpg1.4.x vers cpg1.5.x. Si vous avez fait une nouvelle installation de cpg1.5.x, vous ne pourez pas revenir en arrière du tout!

Pour actuellement rétrograder, remplacez tous les fichiers de cpg1.5.x de votre serveur par les fichiers de votre ancienne versionn (si vous aviez fait une mise à jour avant, voyez plus haut). Puis restaurez votre base de donnée avec la sauvegarde que vosu aviez faite avant la mise à jour. Si vou sn'avez pas de sauvegarde de la base de donnée MySQL, vous ne pourez pas revenir en arrière!