Joomla! Documentation™

Die Testing Joomla! patches Seite beschreibt die Prozedur wie man die Patches testen kann. Dieses Dokument ist die Kurzübersicht mit allen nötigen Schritten.

Joomla Issue Tracker

• http://issues.joomla.org
• Mit dem Github account einloggen (falls Sie noch keinen Account haben, gehen Sie auf https://github.com und richten Sie einen kostenlosen Account ein)
• Statusmeldungen sind: New > Confirmed > Pending > Ready to commit(RTC) > Closed
  • New - gerade gemeldet
  • Confirmed - jemand reproduziert & bestätigte den Fehler
  • Pending - Pending - Es gibt ein Patch (“PR” - pull request);, zwei erfolgreiche Tests sind nötig
  • Ready To Commit - Kann zum Joomla Quelltext hinzugefügt werden
  • Needs Review - Ein erfahrener Entwickler ist nötig um den Patch zu überprüfen.
  • Informationen Erforderlich - Es werden mehr Informationen von der Person benötigt, die das Problem gemeldet hat

Bugs, Reports, Patches testen

• Auf einem lokalen Webserver-Umgebung arbeiten (z.B. XAMPP, MAMP etc.)
• Lade Joomla „staging“ von https://github.com/joomla/joomla-cms hinzufügen
  • Den Ordner herunterlagen und entpacken
  • oder nehme den git Klon https://github.com/joomla/joomla-cms.git Joomla auf dem lokalen Webserver installieren
• Installiere Joomla auf einem Lokalen Webserver
  • Installiere mit den englischen Test Musterdateien
  • Installationsfolder muss nicht entfernt werden!
• Joomla Patch Tester Komponente
  • Herunterladen von: https://github.com/joomla-extensions/patchtester/releases
  • Installiere über Erweiterungen > Installieren
  • Ergänze die eigenen Github Account Details unter Optionen (Nutzername + Passwort
• Gefundene Bugs testen
  • Bugs im Joomla Issue Tracker finden (hilfreiche Filter: status, category, tests, easy)
  • Den Bug nachvollziehen / nachstellen (es geht nicht diesen nachzustellen? => melden)
  • Installiere den Patch in der Joomla Patch Tester component.patch [#ID of patch - einen Titel, welcher das Problem/den Patch beschreibt)]
  • Testen ob der Bug ist gelöst wurde & berichte über die Ergebnisse (nutze @test für erfolgreiche Tests)
  • Entferne den Patch („revert patch“)

Fehler melden

• Suchen Sie im “Issue Tracker” ob das Problem schon gemeldet wurde
• Erstellen Sie eine neues Problem [New Item]
  • Benutzen Sie einen gut beschreibenden Titel
  • Beschreibung:
    • Schritte um den Fehler zu reproduzieren
    • Das erwartete Resultat und das jetzige Resultat
    • Systeminformationen (so viele wie möglich), z.B. die PHP-Version und die Browserversion
    • Zusätzliche Kommentare
  • Die Priorität ist standardmäßig: Medium
  • Version ist im Moment 3.4.x
  • Kategorieangabe: wählen Sie die am besten geeignete Kategorie

Patch erstellen

Patch = Text Datei die Änderungen am Quellcode beschreibt

Methoden:

• Benutze IDE (Entwicklungsumgebung - z.B. Netbeans, PHPStorm)
  • Verbessere den Joomla Code im Editor & erstelle ein .diff Patch!
• Benutze Github: https://github.com/joomla/joomla-cms
  • Navigiere zu der Seite mit dem Code
  • Klicke auf das “Stift” Symbol: “Clicking this button will fork this project so you can edit the file”
  • Verbesserungen hinzufügen
    • Mache Änderungen im Code unter “Edit File”
    • Füge eine Zusammenfassung unter “Commit changes” hinzu (50 oder weniger Zeichen)
    • Im Textfeld bei “Commit Changes” eine umfangreichere Beschreibung einfügen (50 oder mehr Zeichen)
  • Sichern & Pull Request erstellen
• Benutze die Kommandozeile .git (für erfahrene Nutzer)

Weitere Informationen

• Komponente Patchtester: Component Patchtester for Testers
• Joomla! Patches testen: Testing Joomla! patches
• Checklist testen: Testing Checklists
• Bugs und Fehler melden: Filing bugs and issues
• Bug Squad:Bug Squad
• Bug Tracker Ablauf: Bug Tracking Process