App Scripts: Eigene Logik für Shopware-Apps ohne eigenen Server

App Scripts sind kleine Programme in Twig-Syntax, die eine Shopware-App direkt im Shop ausführt, ohne eigenen Server. Sie reagieren auf Hooks wie Warenkorbberechnung oder Seitenaufruf und erlauben Logik, die sonst nur Plugins möglich war.

Das App-System von Shopware 6 trennt Erweiterungen vom Shop: Apps laufen außerhalb und kommunizieren über API und Webhooks. Das hat einen Nachteil: Logik, die während eines Requests laufen muss, etwa ein Aufschlag im Warenkorb, ließ sich so nicht umsetzen. App Scripts schließen diese Lücke seit Shopware 6.4.8. Eine App liefert Script-Dateien mit, Shopware führt sie in einer abgesicherten Twig-Umgebung aus, synchron und innerhalb des Shops. Dadurch funktionieren App Scripts auch in der Shopware Cloud, wo kein eigener PHP-Code ausgeführt werden darf.

Jedes Script hängt an einem Hook, der festlegt, wann es läuft und welche Daten es sieht. Die wichtigsten:

• cart: bei jeder Warenkorbberechnung. Zugriff auf Positionen, Preise, Kunde und Kontext; typischer Hook für Aufschläge, Rabatte oder Gratisartikel.
• product-page-loaded, product-listing-loaded, checkout-confirm-page-loaded und weitere Storefront-Hooks: Daten der Seite erweitern, etwa um zusätzliche Informationen aus einem anderen System.
• api und custom-endpoint: eigene Endpunkte in Admin-API und Store-API, die ein Script beantwortet.
• storefront-custom-page: eigene Seiten in der Storefront rendern.
• order-placed und weitere Ereignis-Hooks: nach einem Ereignis reagieren, etwa Daten an die App senden.

Die Scripts liegen in der App unter Resources/scripts//; der Ordnername bestimmt den Hook.

Ein Script ist eine Twig-Datei, die mit den Daten des Hooks arbeitet und über Services auf Shopware zugreift. Ein Beispiel für einen Mindermengenzuschlag im Warenkorb:

{# Resources/scripts/cart/mindermengenzuschlag.twig #}
{% if hook.cart.price.totalPrice < 30 %}
    {% do services.cart.products.add("ID_DES_ZUSCHLAGARTIKELS") %}
{% endif %}

Verfügbare Services sind unter anderem services.repository zum Lesen von Entitäten, services.cart für Warenkorbaktionen, services.config für die App-Konfiguration, services.response für eigene Endpunkte und services.writer für Schreibzugriffe über den Data Abstraction Layer. Welche Services ein Hook bereitstellt, dokumentiert Shopware in der Script-Referenz.

• Preislogik im Warenkorb: Zuschläge, Staffeln, Gratisbeigaben, Mindestbestellwerte je Kundengruppe.
• Daten anreichern: Produktseiten mit Informationen aus Drittsystemen oder berechneten Werten ergänzen.
• Eigene Endpunkte: kleine Abfragen für Storefront-JavaScript oder externe Dienste ohne Umweg über die App.
• Validierung: Bestellungen blockieren, wenn Bedingungen nicht erfüllt sind.
• Cloud-Kompatibilität: Logik, die in der Shopware Cloud laufen muss, wo Plugins nicht erlaubt sind.

• Kein beliebiger PHP-Code: Scripts laufen in einer Sandbox mit festgelegten Services; Dateisystem, Datenbank und externe Bibliotheken sind nicht erreichbar.
• Externe Dienste: Scripts erreichen Drittsysteme nur über die dafür vorgesehenen Wege; aufwendige Abfragen während der Warenkorbberechnung bremsen den Checkout.
• Performance: Cart-Scripts laufen bei jeder Berechnung. Komplexe Logik oder viele Repository-Abfragen verlangsamen den Shop.
• Debugging: Fehler erscheinen in den Protokollen; eine eigene Entwicklungsumgebung mit aktiviertem Script-Debug erleichtert die Arbeit erheblich.

Plugins laufen als PHP im Shop, haben vollen Zugriff auf Symfony-Services, Events und Datenbank und sind bei komplexer oder performancekritischer Logik die bessere Wahl. App Scripts gewinnen, wenn die Erweiterung als App vertrieben werden soll, in der Cloud laufen muss oder die Logik überschaubar ist. Viele Agenturen kombinieren beides: App für Cloud-Kunden, Plugin für selbst gehostete Projekte. Wie wir Erweiterungen umsetzen, lesen Sie auf unserer Seite zur Shopware-Plugin-Entwicklung; den Unterschied der Formate erklärt der Eintrag App: Cloud-natives Plugin-Format.

Twig, Event (Hook), Webhooks, Erweiterungs-SDK und Store-Erweiterungen. Alle Begriffe im Shopware-Wörterbuch.