Tester les correctifs pour Joomla! - Le guide de références rapides
From Joomla! Documentation
La page Tester les correctifs pour Joomla! décrit la procédure pour les tests de correctifs. Ce document est un guide de références rapides qui résume l'ensemble des étapes de ce processus.
Joomla! Issue Tracker
- http://issues.joomla.org/
- Se connecter avec un compte GitHub -> pas encore de compte ? https://github.com/
- Statut : Nouveau (new) > Confirmé (confirmed) > En attente (pending) > Prêt à être appliqué (ready to Commit - RTC) > Fermé (closed)
- Nouveau - L'anomalie vient d'être rapportée.
- Confirmé - Quelqu'un a pu reproduire et confirmer l'anomalie.
- En attente - Un correctif est disponible (“PR” - pull request) ; 2 tests réussis sont OBLIGATOIRES.
- Prêt à être appliqué - A appliquer au code source de Joomla.
- A besoin d'un avis (needs review) - Besoin d'un développeur confirmé pour régler l'anomalie.
- Information demandée - Besoin de plus d'informations de la part de la personne ayant rapportée l'anomalie.
Tester les anomalies, les rapports et les correctifs
- Travaillez sur un environnement local (XAMPP, MAMP etc)
- Récupérez la version "staging" de Joomla! sur : https://github.com/joomla/joomla-cms
- Téléchargez et dézippez dans le dossier
- ou : faites un clone git https://github.com/joomla/joomla-cms.git
- Installez Joomla! sur votre serveur local
- Installez avec comme option : Test English (GB) sample data
- Ne retirez PAS le dossier d'installation !
- Le composant Joomla! Patch Tester
- Téléchargement depuis : https://github.com/joomla-extensions/patchtester/releases
- Installation via le gestionnaire d'extensions > Installation
- Renseignez les information sur votre compte GitHub dans les Options (nom d'utilisateur et mot de passe)
- Test des anomalies trouvées
- Trouvez des anomalies sur le Joomla! Issue Tracker (filtres utiles : statut, catégorie, tests, facile)
- Reproduire l'anomalie (si vous n'arrivez pas à la reproduire, faites un rapport)
- Installez le correctif avec le composant Joomla! Patch Tester. Correctif : [#ID du correctif – Un titre décrivant le problème ou le correctif]
- Testez si l'anomalie est résolue et faites un rapport (utilisez le texte : @test pour un test réussi)
- Retirez le correctif ("retire le correctif")
Rapport d'anomalie
- Rechercher sur l'Issue Tracker si l'anomalie n'a pas déjà été signalée.
- Créez un nouvel élément [New Item]
- Titre : utilisez un titre descriptif.
- Description :
- Procédure pour reproduire l'anomalie
- Résultat attendu et réel dans les faits
- Informations sur le système (autant que possible). Par exemple votre version PHP, navigateur + version...
- Commentaires supplémentaires
- Priorité : valeur par défaut : Moyenne (Medium)
- Version : 3.4.x-dev (en ce moment)
- Catégories : sélectionnez les catégories les plus appropriées.
Créer un correctif
Correctif (ou patch) = fichier texte qui décrit les changements dans le code source.
Méthodes :
- Utilisation d'un IDE (comme Netbeans, PHPStorm)
- Améliorez le code Joomla! dans l'éditeur et créez un fichier correctif .diff
- Utiliser GitHub : https://github.com/joomla/joomla-cms
- Accédez à la page qui contient avec le code
- Cliquez sur l'icône du "crayon" : "en cliquant sur ce bouton, vous opérez un 'fork' de ce projet, de sorte que vous pouvez éditer le fichier"
- Ajoutez les améliorations :
- Apportez les modifications dans le code sous "Edit file"
- Ajoutez un commentaire de résumé dans "Propose file change" (50 caractères ou moins)
- Ajoutez en cas de besoin une description détaillée
- Enregistrez et choisissez "Pull Request"
- Utilisez la ligne de commande "git" (pour les utilisateurs expérimentés).
Plus d'informations
- Composant Patchtester : Composant PatchTester pour les Testeurs
- Tester les correctifs pour Joomla! : Tester les correctifs pour Joomla!
- Procédure de tests : Feuille de route pour les tests
- Créer un rapport de bogues et d'anomalies : Créer un rapport de bogues et d'anomalies
- La Bug Squad : La Bug Squad
- Procédure de traitement des anomalies : Procédure de traitement des anomalies