Tester les correctifs pour Joomla! - Le guide de références rapides

From Joomla! Documentation

This page is a translated version of the page Testing Joomla! patches QuickReferenceGuide and the translation is 100% complete.

Other languages:
Deutsch • ‎English • ‎español • ‎français • ‎Bahasa Indonesia • ‎Nederlands • ‎português do Brasil

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