Coppermine Photo Gallery - Your Online Photo Gallery

Coppermine Photo Gallery v1.5.12: Documentation et manuel


Table des matières
Passez votre souris ici pour dérouler

Mise à jour

Merci de prendre note: comme il y a eu des changements aussi bien dans les fichiers de Coppermine que dans la base de données 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és et le script update.php doit être exécuté une fois.

Pourquoi mettre à jour ?

Il y a des versions majeures et mineures de Coppermine. Les versions majeures ont été cpg1.0, cpg1.1, cpg1.2.x, cpg1.3.x, cpg1.4.x et cpg1.5.x. La prochaine version majeure sera cpg1.6.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 pour cpg1.5.x. Les versions mineures (représentée par le troisième chiffre dans le numéro de version) représentent les mises à jour, aussi connues sous le 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 ainsi que 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érentiel 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 Coppermine sont corrigés dans ce référentiel. Chaque fois qu'un nouveau paquetage est préparé, toutes les corrections qui ont été faites dans ce référentiel 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 plusieurs corrections de bugs mineurs qui sont inclus dans chaque nouvelle mise à jour, et non uniquement la correction pour un bug majeur ou pour une vulnérabilité qui a nécessité la publication d’une nouvelle version de maintenance. C'est pourquoi, il n'est pas suffisant de juste corriger la faille qui à nécessité la publication de la mise à jour de maintenance. A la place, mettez toujours votre galerie à jour avec la version stable la plus récente dès qu'elle est publiée.

Raisons de publication des paquetages

Voici une liste des versions mineures de cpg1.5.x et la raison pour laquelle elle a été publiée. Ceci pour vous expliquez 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.

Détails

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 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 paquetage 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 paquetage. Le fichier "changelog" se trouve dans le répertoire racine du paquetage 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.

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

Les instructions ci-dessus s'appliquent pour toutes les mises à jour de Coppermine, donc s'il vous plaît prenez le temps de les lires attentivement.

Pour être tout à fait clair:

Il n'y a pas de paquetage séparé pour les mises à niveau - Coppermine vient toujours comme un paquetage complet qui peut être utilisé à la fois pour une nouvelle installation ainsi qu'une mise à niveau.

Action supplémentaires pour la mise à jour depuis une version 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 de 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 aussi une 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

Mise à jour depuis d’une ancienne version de cpg1.5.x vers la version la plus récente de cpg1.5.x

Il n'y a pas d'autres mesures à suivre lors d’une mise à niveau depuis une ancienne version de cpg1.5.x vers la version une plus récente de cette famille. La simple exécution des instructions de base mentionnée ci-dessus dans les Étapes nécessaires lors de la mise à jour de Coppermine (depuis n'importe quelle version) sera suffisante.

Mise à jour du script

Le script de mise à jour va mettre à jour votre base de données 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.

Vous pouvez lancer le script de mise à jour en entrant http://votresite.fr/votre_dossier_coppermine/update.php dans la barre d'adresse de votre navigateur.

Ce qu'il fait

Le script de mise à jour fait trois choses:

Objectif

Le script de mise à jour va mettre à jour la base de données après que vous ayez remplacé manuellement le fichier SQL qu'il utilise. Le script ne va pas détecter pour vous s’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 s’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.à.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 s’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. Cela peut ce faire de 4 manières différentes:

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.

Cela 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 aidez à 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.fr/votre_dossier_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.

Que fait t’il

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

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'option 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. S’il y arrive il va comparer tous les fichiers qui existent sur votre serveur avec les fichiers les plus récents recommandés (en essayant d'obtenir les données depuis le référentiel). Par consé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'interprétation de cet affichage 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êmes:

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:

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

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

Le vérificateur de version est mis à 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 : assurez-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 cela 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. Cela 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 processus 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 d’anycontent.php, regardez la section "Utilisation d'anycontent.php".

L'outil de vérification de version ne télécharge pas les versions de fichiers les plus récente sur internet - il vérifie juste les fichiers que vous avez sur votre serveur à la liste de fichiers la plus récente. L'outil de vérification de version ne vérifie pas, ni désinfecte votre site contre le piratage.

FAQ de mise à jour

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

CPG1.5.x inclue beaucoup de nouvelles fonctions (comparativement aux anciennes versions), nous encourageons 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 complète change entièrement l'aspect de la base de données de Coppermine incluant la conversion de l'encodage vers l'Unicode. Ce processus ne peut pas être annulé: une fois que cette conversion a été faite, la seule manière de revenir en arrière est de faire une restauration complète de la base de données (bien entendu vous devrez créer cette sauvegarde avant que vous ne commenciez la mise à jour). La création d’une sauvegarde de la base de données 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 uniquement 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 pourrez 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 version (si vous aviez fait une mise à jour avant, voyez plus haut). Puis restaurez votre base de données avec la sauvegarde que vous aviez faite avant la mise à jour. Si vous n'avez pas de sauvegarde de la base de données MySQL, vous ne pourrez pas revenir en arrière!