Shopware Plugin entwickeln:was Shopbetreiberwissen sollten

Grundlagen

Was heißt es, ein Shopware Plugin zu entwickeln?

Ein Shopware Plugin zu entwickeln bedeutet, eine Erweiterung zu schreiben, die im Prozess des Shopware-Kerns läuft und dort dieselben Möglichkeiten hat wie der Kern selbst. Sie kann auf Ereignisse reagieren, eigene Daten anlegen, die Datenbankstruktur ändern und sowohl die Administration als auch die Storefront erweitern. Genau diese Nähe zum Kern macht ein Plugin mächtig, und sie ist auch der Grund, warum es bei großen Versionssprüngen Pflege braucht.

Als Shopbetreiber müssen Sie kein PHP lesen können, um ein Plugin-Projekt gut zu steuern. Hilfreich ist aber, die Bausteine zu kennen, aus denen ein Plugin besteht, denn daran lässt sich ein Angebot einordnen: Ein Plugin, das nur ein Template in der Storefront anpasst, ist eine andere Aufgabe als eines, das in den Checkout eingreift, eigene Tabellen anlegt und eine Oberfläche in der Administration mitbringt.

Ob Sie überhaupt bauen lassen oder eine fertige Erweiterung mieten, ist eine eigene Frage. Die behandeln wir ausführlich im Ratgeber Shopware Plugin kaufen oder bauen lassen. Hier geht es um das Wie, also um das, was passiert, wenn die Entscheidung für eine eigene Entwicklung gefallen ist.

Architektur

Plugin oder Shopware App: welcher Weg passt zu Ihrem Shop?

Ob Plugin oder Shopware App, klärt sich meist schon an der Frage, wo Ihr Shop läuft, denn in der Shopware Cloud als SaaS werden Plugins laut Shopware nicht unterstützt. Dort bleibt nur die App. Im selbst gehosteten Shop haben Sie die Wahl.

Eine App liegt im Ordner custom/apps und beschreibt sich über eine Datei namens manifest.xml, die Shopware als Vertrag zwischen Shop und App bezeichnet. Braucht die App eigene Logik auf einem Server, meldet sich dieser beim Shop an, bekommt Ereignisse per Webhook mitgeteilt und arbeitet über die Admin API mit den Daten. Die Datenbankstruktur des Shops kann eine App dabei nicht verändern.

Für Ihre Planung heißt das: Tauscht die Erweiterung vor allem Daten mit einem anderen System aus, ist die App oft der langlebigere Weg, weil sie weniger am inneren Aufbau von Shopware hängt. Greift sie tief in Preisberechnung, Checkout oder Datenmodell ein, landen Sie meist beim Plugin, sofern Ihr Hosting es zulässt.

Aufbau

Shopware Plugin erstellen: woraus besteht ein Plugin für Shopware 6?

Wer ein Shopware Plugin erstellt, beginnt meist mit dem Befehl bin/console plugin:create, der das Grundgerüst mit allen Pflichtdateien anlegt. Danach meldet bin/console plugin:refresh das Plugin im Shop an, und mit plugin:install --activate wird es installiert und aktiviert. Was dann folgt, verteilt sich auf eine Handvoll Bausteine, die in fast jedem Projekt wiederkehren:

1. Basisklasse und composer.json01Jedes Plugin hat eine Hauptklasse, die von der Plugin-Klasse von Shopware erbt, und eine composer.json mit Metadaten wie technischem Namen, Beschreibung und Autor. Dort steht auch, welche Shopware-Versionen das Plugin voraussetzt.
2. Services02Die eigentliche Logik steckt in Services, die Shopware über die Dependency Injection von Symfony bereitstellt. Registriert werden sie in der Service-Konfiguration des Plugins.
3. Events und Subscriber03Ein Subscriber ist eine Klasse, die festlegt, auf welche Ereignisse sie hört, etwa darauf, dass Produkte geladen wurden. Ohne Eintrag in der Service-Konfiguration ruft Shopware ihn nicht auf.
4. Lebenszyklus04Für Installation, Aktivierung, Update, Deaktivierung und Deinstallation gibt es eigene Methoden. Gute Plugins deaktivieren beim Abschalten eigene Daten, statt sie zu löschen, und fragen bei der Deinstallation, ob Daten erhalten bleiben sollen.
5. Storefront05Templates entstehen in Twig. Ein Plugin erweitert eine Vorlage des Shops mit sw_extends und überschreibt gezielt einzelne Blöcke, statt die ganze Datei zu kopieren.
6. Administration06Die Administration baut auf Vue auf. Ein Plugin bringt seine Module und Anpassungen über eine Einstiegsdatei namens main.js mit, die vor der Auslieferung gebaut wird.

Werkzeuge

Was leistet die Shopware CLI bei der Plugin-Entwicklung?

Die Shopware CLI ist ein eigenständiges Kommandozeilenwerkzeug von Shopware, das Erweiterungen baut, prüft, als Archiv verpackt und auf Wunsch in den Shopware Store hochlädt. Sie wird getrennt vom Shop installiert und eignet sich deshalb auch für automatische Abläufe in einer CI/CD-Pipeline. Beim Bauen liest sie aus der composer.json, für welche Shopware-Version das Plugin gedacht ist.

Für die lokale Entwicklung empfiehlt Shopware Docker. Der Vorteil liegt auf der Hand: Alle im Team arbeiten unter denselben Bedingungen, Dienste wie Cache, Warteschlangen und Suche laufen wie im Betrieb, und eine verkorkste Umgebung ist schnell neu aufgesetzt. Die Shopware CLI kann so eine Docker-Umgebung selbst anlegen und starten.

Für Sie als Auftraggeber ist das mehr als eine Geschmacksfrage. Wer reproduzierbar baut und prüft, kann Ihnen jederzeit dieselbe Fassung erneut liefern, und ein Fehler, der beim Entwickler nicht auftritt, beim Hoster aber schon, wird seltener.

Schnittstellen

Wann genügt die Shopware Admin API statt eines eigenen Plugins?

Die Shopware Admin API genügt oft dann, wenn ein anderes System Daten im Shop lesen oder schreiben soll und keine Regel im Ablauf des Shops selbst greifen muss. Shopware beschreibt sie als Schnittstelle für Integrationen, Automatisierung, Datenabgleich sowie Importe und Exporte, mit Lese- und Schreibzugriff auf jede Entität. Für viele Datensätze auf einmal gibt es einen eigenen Sync-Endpunkt.

Typisch ist das bei der Anbindung von Warenwirtschaft, PIM oder Versand: Bestände, Preise und Bestellstatus wandern über die Schnittstelle, und im Shop bleibt kein zusätzlicher Code zurück, der bei Updates gepflegt werden muss. Wie so eine Anbindung geplant wird, zeigt unser Beitrag zur Shopware-Anbindung an ERP und Warenwirtschaft.

Die Grenze liegt dort, wo etwas bei jeder Bestellung oder jedem Seitenaufruf im Shop passieren muss, etwa eine eigene Preisregel im Warenkorb. Das kann keine Schnittstelle von außen leisten, dafür braucht es ein Plugin oder eine App.

Qualität

Woran erkennen Sie gute Shopware Plugin Entwicklung?

Gute Shopware Plugin Entwicklung erkennen Sie daran, dass Tests, statische Analyse und eine klare Versionsangabe zum Lieferumfang gehören und nicht erst auf Nachfrage kommen. Shopware bringt dafür die Grundlage mit: Plugins lassen sich mit PHPUnit testen, einschließlich Integrationstests mit Datenbank, und die vollständige Prüfung der Shopware CLI bündelt Werkzeuge wie PHPStan, ESLint und Stylelint.

Ein besonderes Augenmerk verdient die Kompatibilität. Mit Shopware 6.7 wechselte die Administration beim Bauen von Webpack auf Vite, die Kompatibilitätsschicht für Vue 2 fiel weg und das Framework sprang auf Symfony 7. Plugins mit Komponenten in der Administration brauchten deshalb getrennte Fassungen für 6.6 und 6.7. Fragen Sie also, für welche Versionen ein Plugin gebaut und getestet ist, und planen Sie das nächste große Update mit ein; worauf es dabei ankommt, steht im Leitfaden zum Shopware-Update. Shopware 6.8 ist laut Hersteller für 2027 geplant (Stand Oktober 2026).

Wer sein Plugin in den Shopware Store bringen will, durchläuft zusätzlich eine Prüfung, die zuerst automatisch mit PHPStan und SonarQube und danach von Hand erfolgt. Für ein Plugin, das nur in Ihrem Shop läuft, ist das keine Pflicht, die Maßstäbe taugen aber auch dort als Messlatte.

Ablauf

Wie läuft es ab, wenn Sie ein Shopware Plugin entwickeln lassen?

Wenn Sie ein Shopware Plugin entwickeln lassen, beginnt die Arbeit mit einer Beschreibung des Ablaufs und erst danach mit Code. Wer klickt was, in welcher Reihenfolge, mit welchen Daten, was passiert bei Fehlern, und was soll am Ende anders sein? Je genauer diese Sätze sind, desto belastbarer wird die Schätzung.

Daraus entsteht ein Konzept, das festhält, ob Plugin oder App, welche Bausteine gebraucht werden und für welche Shopware-Versionen gebaut wird. Es folgen Umsetzung, Tests auf den vereinbarten Versionen, Abnahme in einer Testumgebung und erst dann der Einsatz im Live-Shop. Danach beginnt die Wartung, die bei jedem größeren Shopware-Update wieder fällig wird.

Bei der Shopware-Entwicklung bei Scalableloops läuft das in drei Schritten: ein kostenloses Erstgespräch, ein Konzept mit Angebot und die Umsetzung mit Test auf Shopware 6.6 und 6.7. Entwicklung, Wartung und Support liegen bei uns, und Ihre Ansprechpartner sind die Entwickler selbst. Wie so ein Ergebnis aussehen kann, zeigen unsere eigenen Erweiterungen, etwa die Google-Ads-Anbindung für Shopware, die Conversions über Browser und Server meldet.

Vorbereitung

So bereiten Sie die Shopware Plugin Entwicklung vor

1. 01Ablauf aufschreibenHalten Sie in wenigen Sätzen fest, wer was tut, mit welchen Daten, welche Ausnahmen es gibt und was danach anders sein soll.
2. 02Hosting und Version klärenNotieren Sie, ob Ihr Shop selbst gehostet oder in der Shopware Cloud läuft und welche Shopware-Version aktiv ist. Das entscheidet zwischen Plugin und App.
3. 03Qualität ins Angebot schreibenFragen Sie nach Tests, statischer Analyse, unterstützten Versionen und Übergabe des Codes, bevor Sie beauftragen. Für ein erstes Gespräch können Sie eine kostenlose Beratung anfragen.