Einführung

Was ist eine State Machine?

Vieles in Shopware durchläuft eine feste Menge von Status. Eine Bestellung beginnt als Offen, wird In Bearbeitung und dann Abgeschlossen oder Abgebrochen. Eine Zahlung ist Offen, dann Bezahlt, Erstattet und so weiter. Eine Lieferung folgt ihrem eigenen Weg.

Jedes davon ist eine State Machine: eine benannte Liste möglicher Zustände plus die Übergänge, die festlegen, in welchen Zustand als Nächstes gewechselt werden darf und welche Aktion den Wechsel ausführt. Der Status einer Bestellung ändert sich immer nur, indem einer dieser Übergänge befolgt wird — er kann niemals in einen Zustand springen, für den es keinen Übergang gibt.

Shopware liefert mehrere dieser Machines mit und stützt darauf die Bestellabwicklung und Zahlungen. Normalerweise lassen sie sich nur über Datenbank-Migrationen ändern, die ein Entwickler schreibt, und es gibt keine Stelle im Admin, um sie auch nur anzusehen.

Was dieses Plugin hinzufügt

Der State-Machine-Manager gibt Ihnen ein eigenes Admin-Modul, um direkt mit State Machines zu arbeiten:

• Durchsuchen Sie jede State Machine in Ihrem Shop in einer Liste.
• Prüfen und bearbeiten Sie jede Machine über fünf Tabs — Allgemein, Zustände, Übergänge, Diagramm und Verlauf.
• Zustände verwalten — neue hinzufügen, umbenennen und den Anfangszustand wählen.
• Übergänge verwalten — festlegen, welche Aktion von einem Zustand in einen anderen führt.
• Den Ablauf zeichnen in einem interaktiven Diagramm, Zustände umordnen und durch Ziehen verbinden.
• Validieren Sie eine Machine, um häufige Konfigurationsprobleme zu erkennen.
• Eigene benutzerdefinierte State Machines für Ihre eigenen Prozesse erstellen.

Für wen es gedacht ist

Das Modul richtet sich an Shop-Betreiber und Administratoren, die verstehen oder anpassen müssen, wie sich Status verhalten — zum Beispiel einen Zwischenstatus für Bestellungen hinzufügen, einen Zustand umbenennen, damit er für Ihr Team verständlicher ist, oder genau nachvollziehen, welche Statuswechsel möglich sind.

Es ist mächtig, deshalb kommt es mit Leitplanken. Die Kern-State-Machines von Shopware können nicht gelöscht werden, und kein Zustand, Übergang oder keine Machine, die noch in Verwendung ist, lässt sich entfernen. Beim Bearbeiten einer Machine wird immer eine Warnung angezeigt, weil das Ändern der falschen Sache die Bestellabwicklung und Zahlungsabläufe beeinträchtigen kann.

Nächste Schritte

• Installation — bringen Sie das Modul in Ihren Admin.
• Oberfläche im Überblick — ein Rundgang durch die Liste und die Detail-Tabs.