Migrieren von Shopify Scripts zu Shopify Functions

Shopify Functions ähneln Shopify Scripts. Entwickler können damit benutzerdefinierte Commerce-Erlebnisse erstellen.

Plananforderung

Shopify Scripts und die Script Editor-App sind nur für Shops mit dem Shopify Plus-Plan verfügbar. Die Script Editor-App steht im Shopify App Store nicht mehr zum Download zur Verfügung.

Am 28. August 2025 wird Shopify Scripts entfernt und funktioniert dann nicht mehr. Migriere deine vorhandenen Scripts vor diesem Datum zu Shopify Functions.

Shopify Functions

Shopify Functions werden als Teil einer App installiert. Sie werden zusammen mit anderen Funktionen direkt in deinem Shopify-Adminbereich konfiguriert. Das bedeutet, dass Händler beim Erstellen oder Ändern von Anpassungen keinen Code verwenden müssen. Die WebAssembly-Plattform, die Shopify Functions ausführt, bietet eine bessere Leistung als Shopify Scripts, indem Code in unter 5 Millisekunden ausgeführt wird. Daher können Shopify Functions große Verkaufsereignisse wie Flash-Verkäufe ohne Leistungsrückgang unterstützen.

Mithilfe von Shopify Functions können Entwickler Tests in ihrer eigenen lokalen Umgebung programmieren und Komponententests durchführen. Entwickler vertreiben ihre Shopify Functions-Anpassungen als Teil einer App, anstatt Ruby-Code zu kopieren und in jeden Shop einzufügen. Schließlich werden die Probleme durch Zeitüberschreitungen und begrenzte CPU-Speicherkapazitäten durch die Verwendung von Shopify Functions reduziert.

Migration zu Shopify Functions mit dem Shopify Scripts-Anpassungsbericht

Der Shopify Scripts-Anpassungsbericht ist eine personalisierte Seite im Shopify-Adminbereich, auf der die bestehenden Scripts-Anpassungen anzeigt werden, die in deinem Shop aktiv sind. Darüber hinaus findest du dort Shopify Functions-Dokumentationen und relevante App-Links, mit denen du die Anpassungen erneut erstellen kannst.

Die Shopify Scripts-Anpassungsberichte werden automatisch generiert. Du kannst die Berichte auch exportieren und als CSV-Datei anzeigen. Du musst die Anpassungen mit Shopify Functions vor dem 28. August 2025 neu erstellen.

Überprüfe deine Anpassungen

Abhängig von den vorliegenden Skripten kann die Berichtsseite Abschnitte zu Anpassungen von Zahlungs-Gateways, des Versands und von Produktrabatten enthalten.

Jeder Abschnitt kann den Namen, die Beschreibung und die Quelldatei-Links deiner Shopify Scripts-Anpassungen, Links zu empfohlenen Apps, die mit Shopify Functions erstellt wurden und spezifisch für deine Anpassung sind, sowie Links zu Shopify Functions-Tutorials enthalten.

Überprüfe die Informationen im Bericht, um zu entscheiden, ob du die Anpassung mit den folgenden Optionen neu erstellen möchtest:

• eine eigene Lösung mit Shopify Functions erstellen
• Apps, die auf Shopify Functions basieren, installieren

Hinweis

Auf Shopify Functions basierende Apps müssen die Shopify App Bridge verwenden. Benutzerdefinierte Apps, die im Shopify-Adminbereich erstellt werden, unterstützen die Shopify App Bridge nicht. Benutzerdefinierte Apps, die auf Shopify Functions basieren, müssen also über das Partner Dashboard erstellt und dann mit deinem Shop verbunden werden.

Die Anpassungen neu erstellen

1. Gehe in deinem Shopify-Adminbereich zu Einstellungen > Apps und Vertriebskanäle.

2. Klicke auf Script Editor.

3. Klicke im Banner Dein Shopify Scripts ersetzen auf Shopify Scripts ersetzen.

4. Führe in jedem Abschnitt des Anpassungsberichts einen der folgenden Schritte aus:

   • Um die bestehenden Shopify Scripts-Anpassungen anzuzeigen, klicke unter der Anzahl der automatisch erkannten Anpassungen auf den Namen des Skripts.
   • Um kompatible Apps anzuzeigen oder zu installieren, die zu deinen Skripts passen, klicke für eine App, die du verwenden möchtest, im Abschnitt Empfohlene Apps auf Installieren. Um nach anderen kompatiblen Apps zu suchen, kannst du auch auf Weitere Apps wie diese klicken.
   • Um Shopify Functions-Tutorials anzuzeigen, klicke im Abschnitt Wie man mit Shopify Functions neu erstellt auf den entsprechenden API-Link für die Funktion.

Wenn du einen Test mit einer App oder einer Shopify Functions-Anpassung erfolgreich abgeschlossen hast, kannst du das Skript, das du ersetzt, deaktivieren.

Shopify Scripts mit Shopify Functions verwenden

Shopify Scripts funktionieren weiter in Checkouts, die mit checkout.liquid angepasst wurden, und für Checkouts, die bis zum 28. August 2025 aktualisiert wurden.

Shopify Scripts und Shopify Functions können gleichzeitig im gleichen Shop verwendet werden. Wenn deine Skripts derzeit nicht durch die Verwendung von Shopify Functions ersetzt werden können, verwende Shopify Scripts weiterhin, bis die Shopify Functions-APIs deinen Anforderungen entsprechen. Informiere dich in den folgenden Informationen, wie Shopify Scripts und Shopify Functions interagieren.

Einzelartikel-Skripte

Positionsskripte werden vor Shopify Functions ausgeführt, wozu auch Rabatte gehören, die von Apps erstellt werden. Positionsskripte können nicht auf die Beträge zugreifen, die von Funktionen und Apps reduziert wurden.

Skripts können nur auf den ersten Rabattcode zugreifen, der auf den Checkout angewendet wurde, und nicht auf andere Rabattcodes, die möglicherweise verwendet wurden. Die Nutzung von reject gilt beispielsweise für den ersten Rabatt, der auf den Checkout angewendet wird, und wirkt sich nicht auf andere Rabatte aus.

Versand-Skripte

Versandskripts werden nach Zustellungsanpassungen ausgeführt, die von Shopify Functions erstellt werden. Skripts können nicht in geänderten Ergebnissen der Umbenennung von Zustellungsanpassungen ausgeführt werden, aber sie können in Anpassungen ausgeführt werden, die sich bewegen oder ausgeblendet werden.

Zahlungs-Skripte

Zahlungsskripts werden nach Zahlungsanpassungen ausgeführt, die von Shopify Functions erstellt werden. Skripts können nicht in geänderten Ergebnissen der Umbenennung von Zahlungsanpassungen ausgeführt werden, aber sie können in Anpassungen ausgeführt werden, die sich bewegen oder ausgeblendet werden.