Comment devenir un Testeur Joomla!
0 j'aime2,237 vues
Ce document présente un guide pour devenir testeur Joomla!, soulignant que toute personne peut contribuer au projet, même sans compétences techniques. Il décrit les étapes nécessaires pour installer Joomla!, utiliser le Joomla! Patch Tester, et effectuer des tests sur les fonctionnalités proposées. Le guide encourage également les testeurs à partager leurs résultats et à tester dans divers environnements pour une évaluation complète.
![[ Pour les utilisateurs avancés & les codeurs ]
L’objectif de cette presentation était de montrer comme il est facile –même pour un débutant–
d’installer “manuellement la version Développement de Joomla en la téléchargeant
Au lieu de la télécharger sur Github, les utilisateurs avancés & les codeurs peuvent bien sûr
utiliser des methods plus sophistiquées comme le clonage, qui présente de multiples
avantages:
On peut aussi tester les procédures d’installation
On peut facilement toujours avoir la dernière version Dev (via push)
NB : Marc Antoine Thevenet me suggérait 3 alternatives à GIT CLI :
GitHub Desktop : https://desktop.github.com
Tortoise : https://tortoisegit.org
GitKraken : https://www.gitkraken.com (his favourite)
Ou de faire un « full clean when reverting »
67](https://image.slidesharecdn.com/slidesharefr-160429231516/85/Comment-devenir-un-Testeur-Joomla-67-320.jpg)
Comment devenir un Testeur Joomla!
- 1. Comment devenir un Testeur Joomla!® CETTE HISTOIRE N’EST PAS INSPIRÉE D’UNE HISTOIRE VRAIE C’EST UNE HISTOIRE VRAIE 1 MARC DECHÈVREV 1.4
- 2. Introduction Marc Dechèvre |marc woluweb.be | woluweb.be | member 1995 : 1er site avec simple éditeur de texte | la graine était là (NB: quand seulement 5 to 10% des gens connectés) (…) Juin 2008 : 1er site avec Joomla!® 1.5 > site perso et pour le fun Juin 2013 : 1er site avec Joomla!® 3.x > comme agence web 2
- 3. Cette présentation Objectif L’idée de cette presentation est de montrer que tout un chacun* peut contribuer à l’amelioration de Joomla! et, en particulier, au Testing Autrement dit, pas besoin d’être codeur ou développeur, VOUS pouvez participer au projet ! Ainsi, nous allons voir Comment installer une Version Développement de Joomla! en incluant Patch Tester Et comment le Testing fonctionne concrètement Cette présentation sur SlideShare www.slideshare.net/woluweb Cette présentation on YouTube (tutos correspondant à l’essentiel de cette présentation) https://www.youtube.com/c/WoluwebWoluweSaintLambert * Cette histoire n’est pas inspirée d’une Histoire Vraie. C’est une Histoire Vraie 3
- 4. Table des matières Introduction Le Seigneur des Patches, Partie I > La Communauté de Joomla! (comment tout a commencé) Le Seigneur des Patches, Partie II > Les Deux Testeurs (comment contribuer) Le Seigneur des Patches, Partie III > Le Retour du Patch Tester (Patch Tester v2 est sorti !) Comment contribuer au-delà Liens utiles Conclusion 4
- 5. Le Seigneur des Patches Partie I LA COMMUNAUTÉ DE JOOMLA! COMMENT TOUT A COMMENCÉ 5
- 6. Chapitre 1 : Aller aux JoomlaDays, prendre un café et partager les idées Tout a commence à Nice @JoomlaDay France 2015 A la pause café, je rencontre Peter Martin (NL), Roland Dalmulder (NL) and Viktor Vogel (DE) On se met à parler Joomla! (noooon, vraiment ?) Je partage quelques idées/réflexions L’une d’entre elles était : “Vous vous souvenez de Joomla! 1.5 ? On pouvait voir pour chaque Catégorie le nombre d’articles Actifs et dans la Corbeille. Cela n’est plus possible dans la version actuelle de Joomla!... Et c’est dommage pcq c’était pratique p.ex. lorsqu’on veut (ré)organiser son contenu, en particulier quand il y a bcp d’articles ou de rédacteurs” En fait, cette discussion informelle avait déclenché un processus qu’on ne pourrait plus arrêter 6
- 7. Chapitre 2 : tenir sa promesse, même si vous ne savez pas encore comment Le jour suivant, Peter Martin m’a dit « j’ai développé une 1e version, peux-tu la tester ? » Sans réfléchir, j’ai répondu « bien sûr ! » D’un côté, j’étais effectivement si excité que cette fonctionnalité puisse voir le jour… 7 Mais d’un autre côté, qqes secondes plus tard, je me sentais comme Sam Gamegie entrant dans le Mordor : « Marc, tu as fait une promesse, maitenant il te faut la tenir, même si tu n’as aucune idée du chemin à emprunter ! » En effet, je n’avais absolument *aucune* idée de comment le Testing de Joomla! fonctionnait…
- 8. Chapitre 3 : la fonctionnalité a été introduite avec Joomla! 3.5 Et cette fonctionnalité est précisément sortie il y a quelques semaines ! Très propre et efficace On peut même cliquer sur chaque compteur pour voir le nb d’éléments correspondants Pas seulement pour les Catégories d’articles, mais aussi pour tout Gestionnaire de Catégories (natif dans Joomla! ou même extension tierce) 8
- 9. En savoir plus sur comment cette fonctionnalité a vu le jour (articles & présentations par Peter Martin) Joomla! Magazine 01 June 2015 > Category Item Count: A Possible New Feature? http://magazine.joomla.org/issues/issue-june-2015/item/2754-category-item-count-a-possible-new-feature 01 July 2015 > Category Item Count: To a Generic Solution http://magazine.joomla.org/issues/issue-july-2015/item/2788-category-item-count-to-a-generic-solution JoomlaDay UK > 13 February 2016 http://fr.slideshare.net/pe7er/developing-new-feature-in-joomla-joomladay-uk-2016 "The Category Item Counter - developing a new feature" https://youtu.be/CK_tYC-Yy_c Joomla!dagen Nederland > 16 April 2016 http://joomladagen.nl/programma/presentaties/hoe-komt-een-nieuw-feature-in-Joomla The Category Counter on the Joomla! Issue Tracker https://issues.joomla.org/tracker/joomla-cms/6916 9
- 10. Le Seigneur des Patches Partie II LES DEUX TESTEURS COMMENT CONTRIBUER 10
- 11. Les codeurs et les testeurs Beaucoup de gens sont comme VOUS et moi : ils aiment Joomla! Et ils participant à l’evolution du code de Joomla, par exemple En corrigeant des bugs En améliorant les fonctionnalités Mais avant qu’un bout de code soit intégré dans la prochaine version de Joomla!, il doit être testé En pratique, au moins deux tests positifs (Successful Tests ) sont nécessaires Voyons maintenant en pratique comment devenir un Testeur Joomla! D’abord, télécharger et installer la dernier version Développement de Joomla Ensuite, télécharger et installer Joomla! Patch Tester Enfin, choisir un “Issue”, suivre les instructions de test et partager le résultat 11
- 12. Télécharger la dernière version Développement de Joomla! Allez sur https://github.com/joomla/joomla-cms Cliquez sur le bouton “Download ZIP” 12
- 13. 13
- 14. Installer Joomla! (sur serveur local ou distant) Décompresser le fichier téléchargé sur votre serveur local (ou distant) Exemple de serveur local : XAMPP * (fonctionne sur toutes les plateformes : ) https://www.apachefriends.org/download.html L’installation est facile (ou voyez des tutos en cas de besoin) Installer Joomla! comme d’habitude, à une exception près : Pour les données d’exemple (“sample data”), choisir : “Test English (GB) sample data” Ceci est important pour que tout le monde travaille sur la même version Après installation, vous pouvez voir en bas à droite de l’interface d’Administration la version sur laquelle vous travaillez (DEV = “développement”) * Au cas où votre installation “gèle” au moment de l’installation de la Base de Données, ouvrez simplement le fichier “php.ini” dans /xampp/php/php.ini et changez “max_execution_time = 30” par “max_execution_time = 3000”. Puis stoppez et relancez votre servuer 14
- 15. 15
- 16. 16
- 17. If you want to keep your testing environment for further usage, go to Components > Joomla! Update, click on the “Options” button and choose “Testing” as Update Channel. Save & Close. 17
- 18. 18
- 19. Télécharger et installer la dernière version de Patch Tester Aller sur https://github.com/joomla-extensions/patchtester Lire la Description & les Instructions Ne pas cliquer sur “Download ZIP” mais cliquer sur l’onglet “releases” Ou allez dirctement sur https://github.com/joomla-extensions/patchtester/releases (lire le “changelog” si vous êtes intéressé) Télécharger la dernière version au format de votre choix (zip, tar.gz, tar.bz2) Exemple : com_patchtester.zip L’installer comme n’importe quelle extension 19
- 20. 20 Cliquez sur le bouton Releases pour télécharger Ou faites defiler la page pour en savoir plus
- 21. 21
- 22. 22
- 23. 23
- 24. 24
- 25. 25
- 26. Découvrir le Joomla! Patch Tester Aller dans Composants > Joomla! Patch Tester Cliquer sur le bouton “Fetch Data” Si vous avez déjà un compte Github, cliquez sur le bouton “Options” pour indiquer votre nom d’Utilisateur et mot de passe Si vous n’avez pas de compte Github, pas de problème : vous pouvez tout à fait utiliser le Patch Tester tel quel 26
- 27. 27
- 28. 28
- 29. 29
- 30. 30
- 31. 31
- 32. Jouer avec le Patch Tester et choisir un “Issue” Après avoir cliqué sur le bouton “Fetch Data”, vous voyez la liste des “Issues” On peut survoler les titres pour en savoir un peu plus via une infobulle Et encore mieux : cliquez simplement sur le bouton “J! Issue” correspondant Ceci va ouvrir le site “Joomla! Issue Tracker”, où vous pouvez plus facilement parcourir tous les “issues” et voir les details, commentaires etc A partir du Patch Tester, vous pouvez Directement rechercher sur base du Numéro d’”Issue” ou de mots-clés Filtrer et trier les “Issues” Choisissez un”Issue” avec lequel vous vous sentez confortable Cliquez sur le bouton “Apply Patch” Le Patch active est indiqué avec un arrière-plan vert. On peut également les filtrer 32
- 33. 33
- 34. 34
- 35. 35
- 36. Suivre les instructions du test Certains “issues” peuvent être plus ou moins techniques Comme premier “issue”, choisissez un sujet où vous êtes à l’aise Pour cette démo, j’ai sélectionné l’”Issue” #9865 “Single registered article guest view” https://issues.joomla.org/tracker/joomla-cms/9865 Attention : les captures d’écran suivantes illustrent le test de cet “Issue” #9865 Ils sont donc spécifique à cet exemple précis Lire les instructions attentivement Et commencez le testing Attention : soyez aussi méticuleux et systématique que possible Par exemple : essayez toutes les combinaisons, soyez challenging, pensez “out of the box” (vous pouvez même tester pour différentes versions PHP, différentes conditions, dans un environnement multilingue, …) Si vous donnez un “Go”, le patch DOIT être positif sous toutes circonstances… 36
- 37. 37
- 42. Test sans le patch proposé Avant d’appliquer le Patch, je m’assure que je peux reproduire l’”issue” 42
- 43. 43
- 45. Test avec le patch proposé J’applique ensuite le patch Et je vérifie qu’il fonctionne comme prévu sous toutes les circonstances auxquelles on peut penser 45
- 46. 46
- 48. “Inverser” le patch avant de tester un autre “issue” Une fois le Testing fait, cliquez sur le bouton “Revert Patch” avant d’entreprendre un autre “issue” NB : à moins que demandé explicitement, il ne faut tester qu’un seul Patch à la fois (parce qu’un Patch donné pourrait avoir un effet de bord sur d’autres) 48
- 49. 49
- 50. Partagez votre feedback sur le Joomla Issue Tracker Rendez-vous sur le Joomla! Issue Tracker https://issues.joomla.org et ouvrez l’”issue” … ou cliquez simplement sur le bouton “J! Issue” correspondant dans le Patch Tester Connectez-vous (ou créez un compte si necessaire) Presque en haut de la page, vous voyez un bouton “Test this” Cliquez dessus Dans les options (“boutons radio”), sélectionnez si le test est positif ou négatif (“(un)successfully”) Si vous avez des commentaires additionnels, n’hésitez pas à les ajouter (sinon, laissez le champ commentaires vide) Cliquez sur le bouton “Submit Test Result” Vous pouvez maintenant voir votre contribution en bas de page Félicitations ! 50
- 51. 51
- 52. 52
- 53. 53
- 54. 54
- 55. Tester aussi sur (duplicata) de sites réels ! Enfin, il est aussi très important qu’un maximum de configurations soient testées Par exemple, si tout le monde utilise seulement Un site test Joomla standard avec données d’exemple (“Sample Data”) Sur un serveur local Sur la même version PHP Et sans aucune extension tierce on risqué de passer à côté de certains effets de bord Bref, pour aller plus loin, le mieux est de Dupliquer des sites réels Les metre à jour avec la dernière version de Développement Joomla version Installer le Patch Tester et tester 55
- 56. Le Seigneur des Patches Partie III LE RETOUR DU PATCH TESTER PATCH TESTER V2 EST SORTI ! 56
- 57. Le novueau Patch Tester : la v2 est sortie ! v1 était déjà un outil pratique et performant Mais encore mieux : la v2 vient de sortir ! v2 n’est pas une “revolution” mais une addition d’une série de petites “ameliorations” v2 est maintenant disponible à la traduction L’interface (UX) est améliorée et plus intuitive, spécialement pour des nouveaux utilisateurs Un grand merci aussi à Michael Babker qui a été fortement impliqué. Son proper résumé de la v2 : “Il a en fait été réécrit depuis la base pour un meilleur support du code du projet Joomla et pour une integration avec Github d’une façon non intrusive. Et contrairement à la plupart des projets joomla.org projects, il est multilingue ;-)” Pour plus d’infos : voir les commits et la presentation sur https://github.com/joomla-extensions/patchtester/releases 57
- 58. Patch Tester > Instructions Extrait de https://github.com/joomla-extensions/patchtester To install the latest released version: Click on the releases link just above the file listing Click on the button to download either the .tar.bz2, .tar.gz, or .zip packages Log into your site's administrator section, go to Extension Manager > Install, and install the extension To use the latest code from this GitHub repo: Download files into Joomla! install. Log into your site's administrator section, go to Extension Manager > Discover, click the "Discover" button, and install the extension. Click Apply Patch to apply the proposed changes from the pull request. Click Revert Patch to revert an applied patch. En lire plus sur le Patch Tester sur le Joomla! Documentation Wiki : https://docs.joomla.org/Component_Patchtester_for_Testers . Tutoriel video : https://www.youtube.com/watch?v=4OWgusZgIfk 58
- 59. Patch Tester Patch Tester v2 est multilingue ! Contribuez à la traduction sur https://crowdin.com/project/joomla-patchtester 59
- 61. Testing > enrichir l’écran de feedback ? NB : entre-temps, cette suggestion est sur https://github.com/joomla/jissues/issues/777 On many occasions, bugs are discovered… only after a new version is officially released. This is often because those Issues were not tested in real conditions (with real websites, with different third-party extensions, on different configurations, etc) Therefore it could be interesting to have an additional option when giving the feedback about a Test So, besides “Not tested” “Tested successfully” “Tested unsuccessfully” It could prove useful to have something like “Tested with an empty website” “Tested with Joomla Test Sample Data” “Tested on a (duplicate of) real website“ This would be useful For the person validating a PR, who can then better assess the quality of testing For the testers, in order to raise consciousness that tests should also be conducted in real conditions and not only on Test Sample Data (see example of the future Router) 61
- 62. Testing > pourquoi ne pas encore faciliter plus le testing et avoir plus de participants ? https://demo.joomla.org allows already two great things : A 90-day free Joomla! demo account But also a Quick Joomla! Test Drive, ie a full installation which only lasts 90 minutes Based on this Quick Joomla! Test Drive which requires no installation and is limited in time, why not having a similar on-line environment with the testing environment and the Patch Tester included ? In one click only, users would then get the chance to participate to the testing ! In particular, this would also easily lower the threshold and increase the number of Testers : Even users without any experience about installing a local server etc would be able to participate But also for experienced users it would be a great plus : if in 1 second I can get ready for testing, I will do it. But if I first have to spend 5 minutes to manually install my environment, I tend to procrastinate… But this suggestion has also downsides, like Everybody would be testing on same environment (PHP version, …) while we want diversity testing should be made easy, but we don’t want to lower the quality of testers/testing this could create vulnerability issues on the test server Can YOU refine this suggestion or do YOU have another idea in order to improve/facilitate Testing ? Please share ! 62
- 63. Testing > tester en groupe Une fois que vous aurez goûté au plaisir de contribuer à votre CMS favori, vous voudrez participer à ce qu’on appellee un "Joomla! Pizza, Bugs & Fun" (session de bug squashing en groupe). Parce que si Joomla! est certainement un super CMS (Système de Gestion de Contenu), c’est surtout une communauté très active… 63
- 64. Au-delà du Testing > comment devenri un “Joomler”: contribuer 10’ par semaine @sanderpotjer Il y a aussi d’autres manières d’être volontaire https://volunteers.joomla.org Voir la presentation de Sander Potjer’s au Joomla! World Conference 2015 @Bangalore, India YouTube : https://t.co/XGgM4ztMDY 64
- 65. Liens utiles 65
- 66. Une page pour les lister tous Joomla! Development Version https://github.com/joomla/joomla-cms Patch Tester Homepage https://github.com/joomla-extensions/patchtester Download https://github.com/joomla-extensions/patchtester/releases = http://joom.la/patchtester Doc https://docs.joomla.org/Component_Patchtester_for_Testers https://docs.joomla.org/Component_Patchtester_for_Testers/nl https://docs.joomla.org/Component_Patchtester_for_Testers/fr Testing Joomla! patches (Issue Tracker & Patch Tester) https://docs.joomla.org/Testing_Joomla!_patches https://docs.joomla.org/Testing_Joomla!_patches/nl https://docs.joomla.org/Testing_Joomla!_patches/fr https://docs.joomla.org/Testing_Joomla!_patches/de How to report Joomla bugs and issues (“Filing Bugs and Issues”) https://docs.joomla.org/Filing_bugs_and_issues https://docs.joomla.org/Filing_bugs_and_issues/fr https://docs.joomla.org/Filing_bugs_and_issues/nl https://github.com/joomla/joomla-cms/blob/staging/.github/CONTRIBUTING.md https://github.com/joomla/joomla-cms/issues/new https://issues.joomla.org If you are a coder : How to Contribute to Joomla through Github http://extensions.joomla.org/blog/item/how-to-contribute-to-joomla-through-github 66
- 67. [ Pour les utilisateurs avancés & les codeurs ] L’objectif de cette presentation était de montrer comme il est facile –même pour un débutant– d’installer “manuellement la version Développement de Joomla en la téléchargeant Au lieu de la télécharger sur Github, les utilisateurs avancés & les codeurs peuvent bien sûr utiliser des methods plus sophistiquées comme le clonage, qui présente de multiples avantages: On peut aussi tester les procédures d’installation On peut facilement toujours avoir la dernière version Dev (via push) NB : Marc Antoine Thevenet me suggérait 3 alternatives à GIT CLI : GitHub Desktop : https://desktop.github.com Tortoise : https://tortoisegit.org GitKraken : https://www.gitkraken.com (his favourite) Ou de faire un « full clean when reverting » 67
- 68. Conclusion 68
- 69. JOOMLA! Le livre CMS dont VOUS êtes le héros Vous vous souvenez de ces livres d’aventure dans lesquels “VOUS êtes le héros” ? Et bien, Joomla! est clairement “le CMS dont VOUS êtes le héros” ! 69
- 70. Merci N’hésitez pas à me contacter Marc Dechèvre +32 474 37 13 12 marc woluweb.be Skype : woluweb woluweb.be twitter.com/woluweb facebook.com/marc.dechevre linkedin.com/in/marc-dechevre-68b8172a 70
- 71. Ah oui, encore une chose… 71 Hidden heart in the Joomla!® logo – sources Joomla! Magazine – august 2014 | Sara Watz, President of Open Source Matters