Joomla! Documentation™

In jeder Software gibt es Fehler, die behoben werden müssen. Das ist auch bei der Open-Source-Software wie Joomla! der Fall. Der Quellcode von Joomla ist frei für jedermann im Internet zugänglich. Außerdem gibt es die Möglichkeit, Bugs zu melden. Gemeldete Bugs werden gefixt und schließlich müssen diese dann getestet werden. Diese Seite erklärt, wie Du dazu beitragen kannst, das Joomla! Projekt durch die Prüfung von vorgeschlagenen Lösungen zu unterstützen. Dazu benötigst Du keine Programmierkenntnisse, alles was nötig ist, ist eine Joomla-installation zum testen. Eine Kurzanleitung für die Tests ist verfügbar unter: Schnelleinstieg Joomla! Patches testen

Der Joomla! 'Staging' Code

Der Joomla! 'Staging' Code ist der aktuelle Code, an dem gearbeitet wird. Alle Fehlerbereinigungen und neue Features werden diesem Code hinzu gefügt.

Zu finden ist der 'Staging' Code unter https://github.com/joomla/joomla-cms, das ist der Code, der installiert werden muss. Wie das zu erfolgen hat ist etwas weiter unten unter Den Test vorbereiten erklärt.

Der Issue Tracker

Der Issue Tracker für Joomla! befindet sich hier: http://issues.joomla.org

Die Liste zeigt die Tracker Elemente von neuen Elementen zu alten Elementen geordnet. Die Reihenfolge kann mit Hilfe des Filters in Suchwerkzeuge geändert werden. Alle Elemente im Tracker für die ein Patch existiert, haben eine Versionsnummer neben dem Titel.

• PR-staging: Das ist Joomla 3.4.x
• PR-3.5.dev: Das ist Joomla 3.5

Diese Auszeichnung wird sich in Zukunft ändern, wenn neue Versionen kommen und alte gehen.

Der Status ist wichtig und hier ist eine Erklärung:

Neu - Unmittelbar nachdem ein Problem gemeldet wurde, erhält es diesen Status. Wenn Du also einen Bug findest, erstelle eine Beschreibung, wie er reproduziert werden kann. Dann wissen diejenigen, die das Problem testen wollen, wie sie den Patch testen können.

Bestätigt - Das Tracker-Team war in der Lage das Problem nach zu vollziehen. Das Coding-Team wird nun nach einer Lösung suchen.

Wartend - Eine Lösung für das Problem wurde gefunden. Ein Patch wurde erstellt und kann getestet werden. Das Problem muss nun getestet werden. Achte auf das Label neben dem Titel, dieses verrät Dir für welche Joomla! Version der Patch erstellt wurde.

Fertig zum Anwenden - Der Patch wurde erfolgreich getestet und der Code kann übergeben werden.

Geschlossen - Der Status gilt für alle Probleme, die nicht weiter bearbeitet werden müssen.

Filtern im Issue Tracker ist nützlich. Die Überwachung kann sinnvoll sein um Meldungen zu erhalten wenn ein Problem aktualisiert wurde.

Im Grunde kannst Du mit den Problemen beginnen, die den Status Wartend haben.

Den Test vorbereiten

Als Erstes muss der 'master' Code aus dem Joomla GitHub Repository geholt werden. Obwohl es verschiedene Wege gibt um den Joomla 'master' Code herunterzuladen diskutieren wir hier lediglich die Download-Option.

Ordner erstellen

Zunächst müssen wir einen Ordner entweder auf dem lokalen Webserver oder auf einem Hosting-Account erstellen, auf den man mit Hilfe des Browsers zugreifen kann. Erstelle den Ordner bugtesting und navigiere zu diesem Ordner mit Hilfe des Explorers oder Finder.

Joomla herunterladen

Gehe zum Joomla GitHub Repository und klicke auf Download ZIP.

Du erhältst eine Kopie des Joomla 'master' Codes als ZIP-Datei. Wenn du die Datei an einem temporären Ort entpackst erscheint ein Ordner mit dem Namen joomla-cms-staging. In diesem Ordner befindet sich der Joomla 'master' Code. Geh in den joomla-cms-staging Ordner und kopiere den kompletten Inhalt in das Verzeichnis bugtesting welches du im vorangegangenen Schritt erstellt hast.

Jetzt kannst du Joomla installieren indem du zu http://localhost/bugtesting navigierst, falls du einen lokalen Webserver benutzt. Nutzt du einen Webhoster navigiere zur entsprechenden URL des Webhosters. Es folgt die normale Joomla Installations-Routine. Für Beispieldaten wähle: Test English (GB) sample data

Das ist wichtig, denn so nutzt jeder die gleichen Daten zum Testen!

Der Ordner installation muss nicht gelöscht werden, denn so kannst du falls nötig einfach alles neu installieren.

Patch Tester herunterladen

Um dir mit dem Testen von Patches behilflich zu sein wurde die Joomla Erweiterung "Patch Tester" entwickelt. Der Patch Tester kann von der Patch Tester Seite heruntergeladen und anschließend über die Joomla Erweiterungs-Verwaltung installiert werden.

Für die Nutzung des Patch Testers ist ein GitHub Konto erforderlich. Der Grund dafür ist, dass es nur eine streng begrenzte Anzahl anonymer Anfragen, die über den Patch Tester gemacht werden können, gibt. Du kannst dich auf dieser Seite für ein GitHub Konto registrieren.

Patch Tester einrichten

Die GitHub Kontodetails können in den Einstellungen des Patch Testers eingetragen werden. Nach der Installation des Patch Testers klicke unter Komponenten -> Joomla! Patch Tester auf Einstellungen in der Ecke rechts oben. Die Einstellungen-Seite öffnet sich und du kannst deinen GitHub-Benutzernamen und -Passwort eintragen.

Hinweis: Wenn du die Zwei-Faktor-Authentifizierung für dein GitHub-Konto aktiviert hast, musst du ein persönliches Token für den Zugriff unter https://github.com/settings/applications generieren und dieses in das Feld GitHub Token einfügen.

Nach Eingabe Ihrer Kontodaten klicke auf Speichern & Schließen. Einmal zurück in die Patch-Tester klicke auf "Daten abrufen" in der oberen linken Ecke um die aktuellen Daten von Github abzurufen.

Du kannst jetzt mit dem Testen beginnen.

Nun kannst du nach einem Eintrag im Issue Tracker gucken welchen du testen möchtest oder einen zufälligen mit dem Button "Auf gut Glück" finden. Zuerst sollte dann das Problem nachgestellt werden. Wenn du das Problem reproduzieren konntest, dann kannst du den Patch installieren.

Die Installation von Patches

Im Patch Tester kann man einen Patch über die ID oder den Titel suchen. Der Tracker Titel kann z.B. so aussehen:

[#4308] - Fixed event dispatching inconsistencies leading to incomplete API

Neben dem # steht die ID und hinter dem - Zeichen kommt der Titel.

Nachdem der Patch gefunden wurde, klicken Sie auf die Blaue Schaltfläche "Patch anwenden". Überprüfe dann bitte, ob der Fehler behoben wurde und das keine neuen Bugs auftreten.

Rückmeldung der Testergebnisse

Nach der Prüfung, teile bitte deine Testergebnis in der Übersicht mit (Verwende dazu die Schaltfläche "Test this"). Jetzt brauchst du nur noch einen Kommentar eintragen wenn es zusätzlich Informationen gibt oder wenn der Test nicht erfolgreich war.

Wenn möglich bitte in einer mehrsprachigen Umgebung ("mit mindestens 3 Inhaltssprachen veröffentlicht") testen. Da möglicherweise Problemen nur in solchen Umgebungen ausgelöst werden.

Patch zurücknehmen

After a patch has been tested it is no longer needed and can be removed from your test installation, this way you are always testing with a clean system. Go back to the Patch Tester and click on the green button Revert Patch. This will remove the patch and you can start testing the next issue.

If you have become enthusiastic to test, give it a try. It takes a bit of effort to set everything up but once that is done, it is fun and easy! In addition you are also contributing to Joomla!.