Wie reporte ich Bugs?

Warum nutzen wir Github Issues?

Wir verabschieden uns von unserem bisherigen Issuetracker (issues.shopware.com) für Bugs und freuen uns, den Schritt zu GitHub Issues für das Bug-Reporting zu machen. Mit dieser Umstellung passen wir unsere Prozesse an die etablierten Standards an und nutzen die Vorteile von GitHub Issues als bewährtem Tool im Bug-Reporting. Nachdem wir das Ideen-Reporting erfolgreich auf UserVoice verlagert haben, ist es der nächste logische Schritt, auch das Bug-Reporting in das dafür vorgesehene und effizientere System zu integrieren.

Was brauche ich?

Um dir die Issues in Github anzusehen benötigst Du erst mal nichts. Wenn Du aber selber ein Issue anlegen möchtest, oder auf bereits angelegte Issues voten oder diese kommentieren möchtest, dann benötigst Du ein Github Account. Diesen kannst Du hier kostenlos erstellen.    

Wurde mein Problem bereits reportet? 

Bevor Du ein neuen Bug-Report erstellst solltest Du erst schauen, ob das Problem eventuell schon bekannt ist. Du findest alle Bug Reports unter folgendem Link: https://github.com/shopware/shopware/issues 

Hier findest Du eine Übersicht allter offenen Bugreports. Durch Stichpunkte im Suchfeld kannst Du gezielt nach Problemen suchen. Lasse hier die Keywords is:issue und is:open in der Suche drin, damit Dir nur Bugreports angezeigt werden, welche noch den Status offen haben. Wenn Du Dir beispielsweise alle offenen Bugreports zur Suche in Shopware finden möchtest, nutzt Du beispielsweise folgenden Suchterm: is:issue is:open search 

Die gefundenen Issues kannst Du dann öffnen, um weitere Informationen und ggf. Kommentare weiterer Nutzer dazu sehen zu können. 

Einer der Faktoren, welcher darüber entscheidet, welche Issues zeitnah umgesetzt werden ist unter Anderem die Anzahl der Reaktionen. Unter jedem Issue hast Du die Möglichkeit durch ein "Daumen Hoch" für das Ticket zu voten und so die Relevanz zu steigern. Zudem hast Du die Möglichkeit durch einen Kommentar im Issue wichtige Aspekte, die noch nicht berücksichtigt wurden, hinzuzufügen. 

Wie erstelle ich einen neuen Bug-Report?

Um einen neuen Bug-Report zu erstellen, klickst Du in der Issue Übersicht rechts oben auf New Issue.

Im nächsten Bildschirm siehst Du folgende Möglichkeiten. Sollte Dein Problem natürlich eine kritische Sicherheitslücke sein, reporte sie bitte unter dem Bereich Report a security vulnerability. Bei allen anderen Bugs klickst Du neben Bug report auf den Button Get started.   

Titel (1): Trage hier einen aussagekräftigen Titel für das Problem ein. Denk daran, dass dies der Titel ist, der in der Issue Übersicht angezeigt wird. Er sollte also schon alles wichtige enthalten.   

PHP Version (2): Es kann immer sein, dass sich verschiedene PHP Versionen unterschiedlich verhalten. Für viele Probleme ist es daher für unsere Entwickler wichtig, die eingesetzte PHP Version zu kennen.  
Wenn Du nicht weißt, auf welcher Shopware Version Deine aktuelle Installation läuft, kannst Du im public Verzeichnis deiner Shopware Installation eine php Datei erstellen mit dem Namen "phpinfo.php" und folgendem Inhalt: 
 

<?php
phpinfo();
phpinfo(INFO_MODULES);
?>

Diese Datei kannst Du dann einfach mit dem Browser aufrufen und die Version auslesen.    

Shopware Version (3): Auch sehr wichtig ist natürlich die aktuell eingesetzte Shopware Version, um das Problem zielgerichtet nachstellen zu können. 

Affected area / extension (4): Wähle hier aus, was Du glaubst, zu welchem Bereich oder zu welcher Erweiterung das Issue gehört.

Expected behaviour (5): Beschreibe hier die Funktion, bei der Du das Problem festgestellt hast und beschreibe was Du erwarten würdest, wie sie zu funktionieren hat.  

Actual behaviour (6): Beschreibe, wie die Funktion entgegen Deiner Erwartungen aktuell funktioniert bzw. was bei der Funktion nicht funktioniert.   

How to reproduce (7): Erstelle eine möglichst Detaillierte Schritt-für-Schritt Anleitung, wie das Problem reproduziert werden kann. Je detaillierter Du das Problem beschreibst, um so leichter ist es für die Entwickler, es nachzustellen und zu beheben. 

Was ist mit Feature Wünschen?

Der Bereich Issues in Github ist ausschließlich dazu da, Bugs zu reporten. Wenn Du uns gerne Ideen und Anregungen für neue Features mitteilen möchtest, haben wir einen eigenen Bereich dafür. Du findest ihn unter https://feedback.shopware.com/.

Wo finde ich meine alten Bug-Reports?

Alle offenen Bug Issues aus dem Issue Tracker werden auch zu Github synchronisiert. Diese wirst Du also auch in Github finden. Bereits geschlossene Tickets aus dem Issue Tracker bleiben vorerst weiterhin auf issues.shopware.com einsehbar. Die Funktion, dort ein neues Issue anzulegen, gibt es aber nicht mehr.