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

Table des matières

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 &
  • 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 2010-06-02
cpg1.5.3 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)

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

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

    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:

    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:

    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:

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

    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

    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!