Github est un service en ligne sur lequel le code de Joomla est hébergé et maintenu. C’est ici que les mises à jour naissent, sont passées en revue et testées, avant d’être publiées.
Vous avez trouvé un bogue dans Joomla et vous aimeriez le corriger ?
Dans cet article, nous allons voir comment vous pouvez soumettre votre code au projet Joomla en utilisant Github. C’est parti !
Il est important d'être familier avec Github. Cependant, vous n'avez pas besoin d'être un expert.
Étape 1. Obtenez votre propre copie de Joomla
Il est nécessaire dans un premier temps de créer une copie du répertoire Joomla CMS.
- Connectez-vous avec votre compte Github.
- Accédez au répertoire Joomla.
- Sélectionnez la branche "staging"
- Cliquez sur le bouton Fork, et attendez la fin du processus.
Une copie du noyau Joomla sera disponible en tant que nouveau répertoire dans votre propre compte Github.
Mon nom d'utilisateur est htmgarcia, donc mon répertoire est disponible sous github.com/htmgarcia/joomla-cms.
Étape 2. Accédez à votre propre répertoire Joomla
- Rendez-vous sur github.com/votre-nom-d-utilisateur-github.
- Cliquez sur l'onglet Repositories.
- Recherchez "joomla-cms" - Ceci est votre copie du code de Joomla.
Pour être sûr que vous êtes bien dans votre copie du code de Joomla (et non dans l'original), recherchez les détails en haut où est mentionné : votre-nom-d-utilisateur-github/joomla-cms avec en dessous la mention du répertoire original.
Étape 3. Modifiez les fichiers et validez les modifications dans votre répertoire
Ici vous avez accès à tous les fichiers du noyau de Joomla :
N'hésitez pas à les éditer en fonction de la contribution que vous souhaitez apporter, comme des améliorations, des corrections de bugs, des suggestions de conception, etc.
Mon exemple sera factice. Le but de cette "amélioration" est d'illustrer les étapes suivantes.
- Je navigue à travers templates/protostar/css/ car je veux éditer template.css.
- Cliquez sur Editer - l'icône en forme de crayon.
Faites les changements de code que vous souhaitez pour améliorer le CMS. Dans ce cas, j'ajoute un joli commentaire au fichier CSS du template. Je vous suggère fortement de faire quelque chose de plus utile que cela :D
Une fois que vous avez terminé, faites défiler vers le bas et cliquez sur le bouton Commit changes.
Un message de mise à jour confirmera que le fichier a été mis à jour.
Étape # 4. Envoyez une demande de revue au répertoire Joomla d'origine
À ce stade, vous avez modifié le code dans votre propre copie de Joomla.
L'étape suivante consiste à effectuer une requête pull, ce qui signifie soumettre vos modifications de votre copie de Joomla au répertoire d'origine.
- Revenez au répertoire de votre compteJoomla - github.com/votre-nom-d-utilisateur-github/joomla-cms
- Cliquez sur New pull request.
L'écran suivant affichera des informations importantes :
- Le fork de base devrait être joomla/joomla-cms avec "staging" comme base sélectionnée.
- Le head fork doit être votre-nom-d-utilisateur-github/joomla-cms avec "staging" sélectionné dans la liste déroulante ‘compare’.
- Si tout est correct, vous pouvez cliquer sur Create pull request.
Une dernière étape de confirmation vous demandera des détails tels que :
- Pull request for issue - Si vos modifications sont destinées à résoudre un problème existant dans cette liste, tapez le numéro ici.
- Écrivez un bref résumé de vos modifications.
- Fournissez des instructions détaillées pour tester vos améliorations.
- Cliquez sur le bouton Create pull request lorsque vous avez terminé.
Étape # 5. Attendez que vos contributions soient examinées
Des membres de la communauté Joomla vont vérifier votre code, le tester et en fonction des résultats, ils décideront s'il vaut la peine de fusionner vos améliorations avec le code principal.
Votre demande de l'étape précédente sera disponible publiquement ici.
Faites attention, pendant les prochaines heures et/ou les prochains jours, à la discussion que votre demande va générer. Il est important de suivre cette conversation jusqu'à ce que votre contribution soit acceptée ou non dans le cœur de Joomla.
******
Si vous souhaitez en savoir plus sur les contributions à Joomla, lisez le document Filing bugs and issues.
Articles qui devraient vous intéresser
Phoca Gallery 3.2.4 : une galerie Joomla pour vos photos
Réussir votre entreprise sur Internet grâce à Joomla
