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

# Tests de Coppermine

Cette section de la documentation a été crée alors que le pack était en phase alpha. elle est restée dans le pack et à été appliquée ainsi, jusqu'à ce que soit atteinte le stade bêta. Lorsque cpg1.5.3 est sorti en Release Candidate, cette partie de la documentation est restée à l'intérieur du pack car étant toujours valide. Enfin, quand cpg1.5.4 a été publié comme version stable le document tests est toujours resté, puisqu’il s’applique toujours en partie: cpg1.5.x est maintenant dans un état où il peut être recommandé pour une utilisation en production, mais il y a probablement encore beaucoup de bugs (c'est le cas pour tous les logiciels), donc si vous pensez que vous avez trouvé un véritable bug, s'il vous plaît lisez cette section à fond, en particulier pour savoir comment créer un rapport de test/bug valide. En cas de doute, merci de ne pas poster un rapport de bug, mais faire une "demande normal d’aide" sur le forum d'aide correspondante.

Pendant vos test de cpg1.5.x, assurez-vous de noter tous les comportements bizarres que vous rencontrez. Cela inclue les erreurs typographiques, les instructions manquantes, ou toutes autres erreurs. Si vous rencontrez une erreur grave, merci de basculer le mode de débogage sur "on" dans la page de configuration et copiez le texte de la fenêtre de débogage de Coppermine dans votre post si un développeur ou quelqu'un qui apporte de l'aide vous le demande explicitement. Cela aidera grandement l'équipe de développement pour l'élimination des problèmes.

## Pas d'aide pour les versions alpha et beta

La communauté de Coppermine est disposée à apporter de l'aide sur le forum officiel de Coppermine pour les versions qui ont officiellement été publiées. Cependant, il n'y a pas d'aide pour les versions alpha ou beta, c'est à dire encore en développement. Seules les versions stables ont un support d'aide.

Si vous avez besoin d'aide, vous devrez utiliser la dernière version stable disponible.

Bien entendu, vous êtes les bienvenus pour poster vos rapports de test pour une version encore en développement. Toutefois, il y a parfois une mince ligne entre un rapport de test valide et une demande d'aide: si vous postez quelque chose en rapport avec une version en développement et qu'il apparait clairement que vous avez négligé de lire la documentation et que vous n'avez pas cherché sur le forum d'abord, vous risquez d'avoir une réponse rude, voir pas de réponse du tout.

## Parties à regarder de manière particulièrement précise

- Merci de tester toutes les facettes de CPG, depuis l'installation à toutes les fonctions disponibles (et ce dans le maximum de thèmes et de langues possibles).
- Si vous avez la possibilité de tester GD et ImageMagick, merci de les tester tous les deux.
- Les nouvelles fonctionnalités de cette version de Coppermine (par rapport à la version précédente) doivent être testées particulièrement méticuleusement.

Merci de rapporter le résultat de vos tests dans la section de test du forum, mais avant d'ouvrir un nouveau sujet, assurez vous que le bug potentiel que vous vous apprêtez à rapporter ne l'a pas déjà été auparavant.

## Liste des fonctions

Voici une liste incomplète des fonctions (prise depuis le fichier changelog) qui sont nouvelles ou qui ont été totalement modifiées dans cpg1.5.x et qui doivent être vérifiez de très près. Vous n'avez pas à les tester toutes (même si plus vous en testez mieux c'est). Il y a une autre liste de nouvelles fonctions dans cpg1.5.x que vous pouvez aussi parcourir.

Principales nouvelles fonctions

- Ajout du support pour les balises <vidéo> et <audio> de l'HTML 5 {Nibbler}
- Ajout d'une option de configuration pour compter les visites de l'administrateur {eenemeenemuu}
- Ajout de la possibilité pour les non administrateurs d'utiliser editpics.php (sujet 59414) {Aditya}
- Ajout d'une option de configuration qui permet à l'administrateur d'évaluer ses propres fichiers {eenemeenemuu}
- Ajout de navigateurs pour les statistiques {GauGau}
- Ajout d'un timestamp pour la balise form_token générée pour une plus grande sécurité, maintenant, nous avons aussi la possibilité de paramétrer la durée de vie de la balise. {SaWey}}
- Ajout de albmgr.js pour piloter les fonctionnalités des gestionnaires d'albums et d'images - sujet 57113 {Sameera}
- Implantation d'un outil administrateur pour convertir le séparateur de mots-clés {Paver}
- Ajout d'un gestionnaire d'images et d'albums pilotés par AJAX {Sameera}
- Ajout d'onglets précédent et suivant, ainsi que d'une liste déroulante d'onglets (avec option de configuration) {Paver}
- Ajout d'un négatif de fil piloté par AJAX {Sameera}
- Recodage du formulaire de téléchargement pour l'affichage d'un formulaire de téléchargement basé sur flash ou sur un formulaire de téléchargement de fichier unique - enlèvement de toutes les autres options {Paver}
- Ajout de niveaux d'accès basés sur les groupes (vignettes, images intermédiaires, originales) {Paver}
- Ajout d'une nouvelle page de téléchargement utilisant swfupload (http://swfupload.org) {Abbas}
- Ajout de la pagination pour les commentaires {Nibbler}
- Ajout de l'option Akismet pour le filtrage des commentaires {GauGau}
- Recodage de la page de bannissement des utilisateurs avec pagination, tri et modifications multiples. Autorisation du bannissement par courriel. Ajout de bannissement par nom d'utilisateur pour les comptes inexistants. {GauGau}
- Redimensionnement de la fenêtre pop-up des images grande taille pour s'adapter à la taille de l'écran {GauGau}
- Ajout du support de DivX (sujet ID 32380) {GauGau}
- Effacement de fichiers anciens par la mise à jour {GauGau}
- Script de mise à jour peut désormais être lancé en utilisant l'authentification par cookie; mécanismes de remplacement existants aussi {GauGau}
- Nouvelle file d'exécution pour les téléchargements multiples basés sur JavaScript {Nibbler}
- Nouveau système de hiérarchie pour les catégories {Nibbler}
- Ajout de la fonction de configuration "réinitialisation" {GauGau}
- Ajout de la fonction d'export (gsoc2007 - drhammond) {Nibbler}
- Ajout de la fonction "permettre aux utilisateurs d'assigner des mots-clés d'albums" {GauGau}
- Les votes sont désormais personnalisables en votes max- et min + activation d'Ajax {SaWey}
- Ajout de la méthode d'identification pour la configuration, possibilité de la régler pour le nom d'utilisateur, l'adresse courriel ou les deux. {SaWey}
- Ajout de la fonction Ajax de négatif de film {Abbas}
- Ajout d'un nouvel installeur, renommage de l'ancien tant que le nouveau n'est pas stable {SaWey}
- Ajout de deux nouveaux niveaux d'accès pour les visiteurs: pas d'accès, vignettes uniquement, vignettes + images intermédiaires, vignettes + intermédiaires + grande taille {GauGau}
- Ajout de la possibilité pour les utilisateurs de créer des albums dans les catégories autorisées par l’administrateur {SaWey}
- Ajout de la fonction "effacer les fichiers âgés de plus de XXX jours" {Frantz}
- Ajout d'un formulaire de contact optionnel avec l'option Captcha {GauGau}
- Ajout de l'option d'administration pour afficher une page de redirection ou pour aller directement à la page cible avec message de succès/erreur en haut de page {GauGau}
- Ajout de la possibilité d'insertion depuis une liste pour le champ de mots clés lors de la modification de fichiers {GauGau}
- Ajout d'un Méta-album navigation par dates {GauGau}
- Augmentation de la capacité du gestionnaire de catégories pour gérer un plus grand nombre de catégories. {Nibbler}

## Le rapport doit inclure

- L'OS du serveur
- Le logiciel du serveur (Apache, IIS etc.)
- Le test de GD1, GD2 ou ImageMagick
- La version PHP
- L'intégration/la passerelle avec un forum (si c'est le cas)
- Les thèmes entièrement testés (entièrement testés, signifie l'utilisation du maximum de fonctions possibles)
- Erreurs majeures
- L'OS et le(s) navigateur(s) du client
- Nouvelle installation ou mise à jour (si mise à jour, depuis quelle version de Cpg)
- Source: avez vous installé en utilisant un pack (si oui: lequel), une archive SVN une mise à jour depuis le SVN (si oui: quelle révision)
- La langue du navigateur / le language de coppermine testé

Si vous le pouvez et que votre installation de test est accessible, donnez un lien vers votre galerie de test. Si vous ne pouvez pas, il est généralement utile d'attacher une copie d'écran à votre rapport.

Le résultat de vos tests ne servira pas uniquement à résoudre les problèmes, mais aussi à vérifier la compatibilité de Coppermine avec un maximum de navigateurs et de systèmes d'exploitation. C'est la raison pour laquelle ces informations sont très importantes même si vous ne trouvez que tout va bien - nous aimerions aussi entendre les échos de vos réussites.

Merci pour votre participation et le temps passé pour rendre Coppermine la première galerie photo open-source !

### Un seul problème par sujet !

Nous avons une politique stricte "une question par sujet" sur l'ensemble du forum de Coppermine qui s'applique encore plus à la section de test: pour permettre à l'équipe de développement de traquer scrupuleusement chaque bug potentiel, il est absolument obligatoire que vous ne postiez qu'un problème (bug potentiel) par sujet. Si vous trouvez plusieurs bugs potentiels, il est tout à fait indiqué d'ouvrir plusieurs sujets.

### Exemple de rapport de test

Pour vous donner une idée de ce à quoi devrait ressembler votre rapport de test voici un exemple (Assurez-vous d'avoir complété les données en rouge avec votre contenu):

Lors du test de cpg1.5.4 sur ma galerie de test sur http://exemple.com/mon_dossier_coppermine/ en utilisant la version du SVN du 2009-07-13 (révision 1234) J'ai noté que lorsque je m'identifie en tant qu'administrateur et quand je clique sur l'option "exporter" du menu administrateur, j'ai le message d'erreur "foo bar blah".
Le serveur de ma galerie test tourne sous Ubuntu Linux 9.04 et Apache 2.2.10 avec GD2 comme librairie graphique et PHP 5.3.0. Je n'utilise pas de passerelle et je n'ai testé qu'avec le thème curve J'ai fais une nouvelle installation. J'ai le message d'erreur ci-dessus quel que soit le navigateur utilisé (J'ai testé avec IE7 et FF3.5 sur Windows XP Home SP3 Français). La langue par défaut de mon navigateur est réglée à Français.

Voici un autre exemple du même rapport de test:

Version de Coppermine: cpg1.5.4
URL de la galerie test: http://exemple.com/mon_dossier_coppermine/
Os du serveur: Ubuntu Linux 9.04
Serveur Web: Apache 2.2.10
Version PHP: 5.3.0
Librairie graphique utilisée: GD2
Intégration: aucune
Thèmes testé: curve
Client OS: Windows XP Home SP3 Français
Navigateur Client: IE7 et FF3.5
Type d'installation: Nouvelle installation
Source: version SVN du 2009-07-13 (révision 1234)
Langue du navigateur: Français
Langue de Coppermine: Français
Ce qui ce passe (bug potentiel): J'ai ce message d'erreur "foo bar blah"
Comment reproduire le problème (ce que j'ai fait lorsque le problème s'est présenté): Je suis identifié en tant qu'administrateur et lorsque je clique sur l'option "exporter" du menu administrateur

Les exemples ci-dessus sont là pour vous montrer ce à quoi peut ressembler votre rapport - vous devrez donner plus d'informations en fonction du type de problème que vous rapportez:

- Si vous rapportez un problème d'orthographe ou de typographie, vous n'avez pas besoin de donner tous ces détails, puisque le système d'exploitation n'a aucun impact la dessus, et donc, un rapport valide traitant d'un problème d'orthographe pourra ressembler à ceci
  en utilisant la version SVN rev 1234 de `lang/french.php` la ligne `$foo = 'bojour le monde';` devrait être `$foo = 'bonjour le monde';`
  ou
  Lorsque je clique sur le lien pour m'identifier, le mot "`bojour`" sur l'écran d'identification devrait être "`bonjour`". J'utilise le pack cpg1.5.4
- Si vous faites un rapport sur un problème visuel, donnez plus de détails sur votre navigateur, la résolution de votre écran etc...
- Pour les rapports de problèmes de téléchargement, assurez-vous d'avoir fait exactement ce qui est suggéré dans la section "Demande d'aide pour un problème de téléchargement". Les rapports de bugs qui montrent que vous n'avez pas suivi les recommandations seront invalides et ignorés.

### Les rapports invalides des versions qui ne sont pas stable

Nous aimerions vraiment voir votre rapport d'essai pour la nouvelle version, donc ne vous découragez pas s’il y a des règles à suivre. Ce que nous n'avons certainement pas besoin ce sont des rapports comme ceux-ci:

J'ai téléchargé la nouvelle version. Elle ne fonctionne pas.

S'il vous plaît faite vous une faveur à vous-même et à nous: ne déposez pas des rapports stupide, car ils ne feront que conduire à la frustration et seront ignorées ou supprimées, et bien sûr feront rire.

Si vous n'avez aucune idée pourquoi ce rapport est un mauvais exemple, alors vous devriez ne même pas envisager de tester la nouvelle version en premier lieu. Au lieu de cela, vous devriez utiliser la version stable.

Pour tous ceux qui ont lu ce point, voici quelques conseils en plus pour vous: les packages publiés ont un numéro de version. Les fichiers ont des numéros de révision. Il y a une raison à cela. Ne postez pas de bêtises comme "J'ai la dernière version". Ecrivez la version actuelle ou le numéro de révision. Et ne vous contentez pas d’écrire uniquement quelque chose comme "ne fonctionne pas". Nous avons besoin de savoir ce qui s'est réellement passé ("`après avoir fait X, Y il ce passe`"), aussi détaillé que possible.

Si vous pensez que les règles ici sont tout à fait évidente, alors pensé y encore: nous ne les écrierions pas si elles étaient évidentes pour tout le monde. En fait, nous avons eu un moment difficile dans le passé, lorsque nous avons été inondés de rapports de test invalide. C'est pourquoi nous avions besoin de clarifier les règles.

## Disponibilité

Lors du test d'une version (par exemple une version SVN vérifier non publiée), assurez-vous que votre version est à jour.