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.
Auf dieser Seite
- Onlineshop und die Storefront API
- Veröffentlichte Skripte
- Maximale Anzahl von Shopify Scripts
- Bestellentwürfe
- Metafelder
- Warenkorb-/Checkout-Attribute
- Rabattcodes
- Positionen
- Versandtarife
- Mehrere Währungen
- Reguläre Ausdrücke
- Themes
- Ressourcen
- Eingabe/Ausgabe
- Zeit und Zufälligkeit
- Zeichenlimit für Skripte
- Abonnementbestellungen
- Beschleunigte Checkouts
- Shopify Point of Sale (POS)
- Zahlungs-Gateways umbenennen
- Geteilter Versand im Checkout
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:
- Benutzerdefinierte Apps, die mit der Storefront API, dem JavaScript Buy SDK oder den Mobile Buy SDKs (Android und iOS) erstellt wurden
- Benutzerdefinierte Apps, die Checkouts generieren
- Die Mobil-App-Builder Tapcart und Plobal Apps
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-Methodestart_with- undend_with-Methodeninclude-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.