Anforderungen und Einschränkungen für Shopify Scripts

Einige Einschränkungen bei Shopify Scripts dienen der Erhöhung der Sicherheit und stellen sicher, dass Skripte jederzeit ausgeführt werden können, unabhängig von der Anzahl der Kund:innen in deinem Shop. Beachte die folgenden Einschränkungen, wenn du Skripte für deinen Shopify-Shop entwickelst.

Onlineshop und die Storefront API

Wenn du ein Skript erstellst oder bearbeitest, wählst du aus, ob es nur in deinem Onlineshop oder in deinem Onlineshop und in den folgenden Apps ausgeführt werden soll:

Damit Skripte funktionieren, muss deine Website über eine integrierte Warenkorbfunktionalität verfügen. Daher kannst du Skripte nicht mit Buy Buttons oder dem Vertriebskanal Facebook and Instagram by Meta verwenden.

Veröffentlichte Skripte

Es kann nur ein Skript pro Skripttyp gleichzeitig veröffentlicht werden. Du kannst beispielsweise ein Positionsskript und ein Versandtarif-Skript veröffentlichen, aber nicht zwei Positionsskripte gleichzeitig.

Maximale Anzahl von Shopify Scripts

Du kannst bis zu 200 Shopify Scripts erstellen.

Bestellentwürfe

Positions-Skripte, Versandtarif-Skripte und Zahlungs-Skripte funktionieren nicht mit Bestellentwürfen oder dem Checkout für Bestellentwürfe.

Metafelder

Shopify Scripts können nicht auf Metafelder zugreifen.

Warenkorb-/Checkout-Attribute

Shopify Scripts können nicht auf Shopify Liquid-Warenkorbattribute zugreifen. Du kannst diese Attribute zu deinen Warenkorbseiten hinzufügen, um zusätzliche Informationen von deiner Kundschaft zu erfassen, aber du kannst kein Skript erstellen, das sie verwendet.

Rabattcodes

Skripte können darauf zugreifen, ob ein Rabattcode angewendet wird, sowie auf den Betrag und die Art des Rabatts (z. B. fester Betrag, Prozentsatz oder Versand). Skripte können nicht darauf zugreifen, wie der Rabattcode angewendet wird, zum Beispiel, ob er für den gesamten Warenkorb oder für eine bestimmte Position gilt. Das bedeutet, dass Skripte nicht auf die Gesamtsummen nach dem Rabatt oder auf automatische Rabatte zugreifen können.

Positions- und Versand-Skripte, die auf Rabatte in einem Warenkorb zugreifen, sind nicht mit Rabattkombinationen kompatibel. Die Methode .discount_code kann nur einen einzigen Rabattcode zurückgeben. Warenkörbe, die durch Rabattkombinationen mehrere Rabattcodes enthalten, werden nicht unterstützt.

Positionen

Skripte können keine Artikel zum Warenkorb hinzufügen oder den Preis eines Artikels erhöhen.

Versandtarife

Skripte können den Preis eines Versandtarifs nicht erhöhen.

Mehrere Währungen

Deine Skripte funktionieren bei der Verwendung von mehreren Währungen möglicherweise nicht wie erwartet. Um sicherzustellen, dass deine Skripte für Warenkörbe oder Checkouts in einer anderen Währung als der primären Währung deines Shops funktionieren, musst du deine Skripte zu Shopify Functions migrieren.

Reguläre Ausdrücke

Der Abgleich mit regulären Ausdrücken wird nicht unterstützt. Wenn du ein Positions-Skript erstellst, kannst du möglicherweise eine der folgenden Methoden als Problemumgehung verwenden:

  • split-Methode
  • start_with- und end_with-Methoden
  • include-Methode

Themes

Möglicherweise musst du dein Liquid-Theme aktualisieren, damit es deine Skripte unterstützt und deine Kundschaft nicht verwirrt wird. Zum Beispiel zeigen nicht alle Themes Positionsrabatte im Warenkorb an. Wenn dies bei dir der Fall ist, musst du dein Theme bearbeiten, um die Positionsrabatte im Warenkorb anzuzeigen. Erfahre mehr über die Arten von Änderungen, die du an deinen Liquid-Themes vornehmen kannst.

Ressourcen

Die Menge an CPU und Arbeitsspeicher, die einem Skript zur Verfügung steht, ist begrenzt. Die für ein Skript reservierten Ressourcen hängen von der Größe des Warenkorbs und von der Menge der Berechnungen ab, die das Skript erfordert. Shopify verfolgt diese Ressourcenlimits sorgfältig, um sicherzustellen, dass sie die beabsichtigte Funktionsweise deines Skripts nicht beeinträchtigen.

Wenn du ein Skript testest, gibt die Konsole des Script Editors aus, wie viel Prozent der zugewiesenen Ressourcen das Skript verwendet.

Eingabe/Ausgabe

Mit wenigen Ausnahmen unterstützen Shopify Scripts keine Eingabe/Ausgabe. Das bedeutet, dass Skripte keine Web-Anfragen oder Datenbankaufrufe ausführen und keine Eingaben von Benutzer:innen erhalten können.

Die puts-Methode kann verwendet werden, um Text in der Konsole in der Script Editor-App auszugeben.

Zeit und Zufälligkeit

Skripte können keine zufälligen oder zeitbasierten Berechnungen beinhalten. Shopify Scripts können nicht auf das Time-Objekt und die rand-Methode zugreifen.

Da Skripte bei jeder Neuberechnung der Warenkorb-Gesamtsumme ausgeführt werden, können Skripte, die auf Zeit oder Zufallszahlengenerierung basieren, unvorhersehbare oder verwirrende Ergebnisse haben, wenn Kund:innen ihren Warenkorb häufig ändern. Du kannst jedoch mit der Launchpad-App die Ausführung von Skripten während bestimmter Events planen.

Skript-Zeichenlimit

Du kannst Skripte mit einer maximalen Länge von 40.960 Zeichen erstellen.

Abonnement-Bestellungen

Wenn deine Positions- und Versand-Skripte einen Rabatt für ein Abonnement-Produkt erstellen, gilt der Rabatt für die folgenden Zahlungen:

  • nur die erste Zahlung einer pro Lieferung bezahlten Bestellung
  • der gesamte Betrag einer im Voraus bezahlten Abonnement-Bestellung

Erfahre mehr über Abonnements und Skripte.

Beschleunigte Checkouts

Wenn du Shopify Scripts mit beschleunigten Checkouts verwendest, werden Versandrabatte erst angewendet, nachdem dein:e Kund:in eine beschleunigte Zahlungsmethode ausgewählt hat. Aus diesem Grund werden Änderungen am Preis der Bestellung nicht auf dem Gerät oder im Browser der Kundschaft angezeigt. Kund:innen sehen im beschleunigten Checkout den ursprünglichen Preis, es wird ihnen aber der korrekte, rabattierte Preis berechnet.

Shopify Point of Sale (POS)

Shopify Scripts funktionieren nicht mit Shopify Point of Sale (POS).

Umbenennen von Zahlungs-Gateways

Du kannst keine Zahlungs-Gateways umbenennen, bei denen Bilder oder Logos als Name des Gateways angezeigt werden. Zahlungs-Gateways mit Logo-Bildern neben ihrem Namen können umbenannt werden.

Geteilter Versand im Checkout

Versand-Skripte sind nicht mit dem geteilten Versand im Shopify Checkout kompatibel. Wenn du Versand-Skripte verwendest und den geteilten Versand aktivierst, werden deiner Kundschaft im Checkout keine aufgeteilten Lieferungen angezeigt.