Apps: Das cloudfähige Erweiterungsformat von Shopware 6

Apps sind das Erweiterungsformat, das Shopware 6 für die Cloud entwickelt hat: Sie laufen außerhalb des Shops, sprechen über APIs und Webhooks mit ihm und bringen mit App Scripts trotzdem Logik in den Request. Klassische Plugins laufen dagegen als PHP-Code im Shop.

Für Shopware-Händler in Österreich und Deutschland gleichermaßen relevant: Mit Shopware 6.4 hat Shopware neben Plugins ein zweites Erweiterungsformat eingeführt. Eine App besteht im Kern aus einer manifest.xml, die beschreibt, was die App darf und wo sie eingreift, sowie optional aus Templates, Scripts, Konfigurationsschemata und Admin-Modulen. Eigener serverseitiger Code läuft nicht im Shop, sondern auf einem Server des App-Anbieters, der über die Admin-API zurückruft.

Der Grund für dieses Design ist die Shopware Cloud: In einer gemeinsam genutzten Umgebung darf kein fremder PHP-Code ausgeführt werden. Apps machen Erweiterungen trotzdem möglich, und zwar in einem Format, das in der Cloud und in selbst gehosteten Shops gleichermaßen funktioniert.

• Ausführung: Plugins laufen als PHP innerhalb von Shopware, Apps außerhalb (plus App Scripts im Shop).
• Zugriff: Plugins erreichen alle Symfony-Services, Events und die Datenbank. Apps nutzen Admin-API, Store-API, Webhooks und definierte Script-Services.
• Hosting: Plugins brauchen einen selbst gehosteten Shop. Apps laufen auch in der Shopware Cloud.
• Sprache: Plugins sind PHP. Der Server einer App kann in jeder Sprache geschrieben sein.
• Berechtigungen: Apps deklarieren im Manifest, auf welche Entitäten sie zugreifen; der Händler bestätigt das bei der Installation.
• Updates: Apps aktualisieren Manifest und Scripts über den Store, ihre Serverlogik unabhängig davon.

Eine minimale manifest.xml enthält Metadaten, Berechtigungen und die Registrierungs-URL:

    
        MeineApp
        Meine App
        1.0.0
        solution25
    
    
        https://app.example.com/register
    
    
        order
        product
    
    
        
    

Weitere Bausteine sind Admin-Module (eigene Seiten in der Administration per iframe), Action Buttons, Payment-Endpunkte für eigene Zahlungsarten, Custom Fields, Rule Conditions, Flow-Builder-Aktionen, Storefront-Templates und App Scripts.

Bei der Installation ruft Shopware die Registrierungs-URL der App auf und tauscht Secrets aus; die App erhält pro Shop einen eigenen API-Zugang. Danach läuft die Kommunikation in beide Richtungen: Shopware schickt Webhooks bei Ereignissen, die App liest und schreibt über die Admin-API. Jede Anfrage ist signiert, sodass beide Seiten die Herkunft prüfen können. Shopware stellt für die App-Seite ein PHP-SDK und ein Symfony-Bundle bereit, die Registrierung, Signaturprüfung und API-Client übernehmen.

• Die Erweiterung soll im Shopware Store auch für Cloud-Kunden angeboten werden.
• Die Logik lebt ohnehin in einem externen System, etwa einem ERP, einem Zahlungsanbieter oder einem KI-Dienst.
• Sie möchten unabhängig von PHP-Versionen und Shopware-Deployments ausliefern und aktualisieren.
• Mehrere Shops sollen denselben Dienst nutzen, der zentral betrieben wird.

Ein Plugin bleibt die bessere Wahl, wenn Logik tief in Checkout, Preisberechnung oder Datenmodell eingreift, hohe Performance braucht oder keine externe Infrastruktur betrieben werden soll. Mehr dazu auf unserer Seite zur Shopware-Plugin-Entwicklung.

• Berechtigungen minimal halten: nur die Entitäten anfordern, die die App wirklich braucht; Händler sehen die Liste bei der Installation.
• Webhooks idempotent verarbeiten: Zustellungen können sich wiederholen; eventId zur Deduplizierung nutzen.
• Payload nachladen: Webhooks liefern nur IDs; den aktuellen Zustand über die Admin-API holen.
• Versionierung: Manifest-Version sauber pflegen, Breaking Changes vermeiden, Migrationspfade dokumentieren.
• Betrieb absichern: Der App-Server ist Teil des Shops. Monitoring, Backups und Verfügbarkeit gehören zum Angebot.

App Script, Plugin, Erweiterungs-SDK, Store-Erweiterungen und PaaS auf Platform.sh. Alle Begriffe im Shopware-Wörterbuch.

Sie planen eine eigene Shopware App für Ihren Shop in Österreich? Wir betreuen Onlinehändler in Österreich und Deutschland, aus Bremen und Prishtina, und setzen Shopware-Projekte von der Beratung bis zum Betrieb um.