Vereisten en beperkingen van Shopify-scripts

Sommige beperkingen voor Shopify-scripts bestaan om de veiligheid te verbeteren en om ervoor te zorgen dat scripts kunnen worden uitgevoerd, ongeacht hoeveel klanten je winkel op een bepaald moment gebruiken. Houd rekening met de volgende beperkingen als je scripts voor je Shopify-winkel ontwikkelt.

Op deze pagina

Webshop en de Storefront API

Wanneer je een script aanmaakt of bewerkt, kies je of het alleen in je webshop wordt uitgevoerd, of in je webshop en in de volgende apps:

Gepersonaliseerde apps gebouwd met de Storefront API, JavaScript Buy SDK of Mobile Buy SDKs (Android en iOS)
Gepersonaliseerde apps die checkouts genereren
Tapcart- en Plobal Apps-app-bouwers voor mobiel

Je website moet een ingebouwde winkelwagenfunctionaliteit hebben om scripts te laten werken. Je kunt scripts dus niet gebruiken met Buy Buttons of het Facebook and Instagram by Meta-verkoopkanaal.

Gepubliceerde scripts

Er kan maar één script per scripttype tegelijk worden gepubliceerd. Je kunt bijvoorbeeld een orderregelscript en een verzendtariefscript publiceren, maar je kunt niet twee orderregelscripts tegelijk publiceren.

Maximum aantal Shopify-scripts

Je kunt maximaal 200 Shopify-scripts aanmaken.

Conceptbestellingen

Scripts voor orderregels, verzendtarieven en betalingen werken niet met conceptbestellingen of de checkout voor conceptbestellingen.

Metavelden

Shopify-scripts hebben geen toegang tot metavelden.

Winkelwagen- en checkoutattributen

Shopify-scripts hebben geen toegang tot Shopify Liquid-winkelwagenattributen. Je kunt deze attributen aan je winkelwagenpagina's toevoegen om extra informatie van je klanten te verzamelen, maar je kunt geen script aanmaken dat ze gebruikt.

Kortingscodes

Scripts hebben toegang tot de informatie of er een kortingscode is toegepast, het kortingsbedrag en het soort korting (zoals een vast bedrag, een percentage of verzending). Scripts hebben geen toegang tot de manier waarop de kortingscode wordt toegepast, bijvoorbeeld of deze specifiek is voor de winkelwagen of voor een orderregel. Dit betekent dat scripts geen toegang hebben tot totalen na korting of tot automatische kortingen.

Scripts voor orderregels en verzending die toegang hebben tot kortingen die op een winkelwagen zijn toegepast, zijn niet compatibel met kortingscombinaties. De methode .discount_code kan slechts één kortingscode retourneren. Winkelwagens die meerdere kortingscodes bevatten via kortingscombinaties, worden niet ondersteund.

Orderregels

Scripts kunnen geen artikelen aan de winkelwagen toevoegen of de prijs van een artikel verhogen.

Verzendtarieven

Scripts kunnen de prijs van een verzendtarief niet verhogen.

Meerdere valuta

Je scripts werken mogelijk niet zoals verwacht met meerdere valuta. Om ervoor te zorgen dat je scripts werken voor winkelwagens of een checkout in een andere valuta dan de primaire valuta van je winkel, moet je je scripts migreren naar Shopify Functions.

Reguliere expressies

Het matchen van reguliere expressies wordt niet ondersteund. Als je een script voor orderregels aanmaakt, kun je als tijdelijke oplossing mogelijk een van de volgende methoden gebruiken:

split-methode
start_with- en end_with-methoden
include-methode

Thema's

Mogelijk moet je je Liquid-thema updaten om je scripts te ondersteunen en om verwarring bij je klanten te voorkomen. Niet alle thema's geven bijvoorbeeld orderregelkortingen weer in de winkelwagen. Als dit het geval is, moet je je thema bewerken om de orderregelkortingen in de winkelwagen weer te geven. Meer informatie over de soorten wijzigingen die je kunt aanbrengen in je Liquid-thema's.

Middelen

De hoeveelheid CPU en geheugen die beschikbaar is voor een script is beperkt. De middelen die voor een script zijn gereserveerd, zijn afhankelijk van de grootte van de winkelwagen en de hoeveelheid berekeningen die het script vereist. Shopify houdt deze limieten voor de middelen zorgvuldig bij om ervoor te zorgen dat ze niet verhinderen dat je script naar behoren werkt.

Wanneer je een script test, geeft de console van de Script Editor het percentage weer van de toegewezen middelen dat het script gebruikt.

Input/output

Op een paar uitzonderingen na zijn Shopify-scripts niet geschikt voor input/output. Dit betekent dat scripts geen webaanvragen of database-aanroepen kunnen uitvoeren en ze geen invoer van een gebruiker kunnen krijgen.

De puts-methode kan worden gebruikt om tekst af te drukken in de console in de Script Editor-app.

Tijd en willekeur

Scripts kunnen geen willekeurige of op tijd gebaseerde berekeningen bevatten. Het Time-object en de rand-methode zijn niet toegankelijk voor Shopify-scripts.

Omdat scripts elke keer worden uitgevoerd wanneer het totaalbedrag van een winkelwagen opnieuw wordt berekend, kunnen scripts op basis van tijd of het genereren van willekeurige getallen onvoorspelbare of verwarrende resultaten hebben als een klant de winkelwagen vaak wijzigt. Je kunt scripts echter plannen om tijdens events te worden uitgevoerd met de Launchpad-app.

Tekenlimiet voor scripts

Je kunt scripts aanmaken van maximaal 40.960 tekens.

Abonnementsbestellingen

Als je scripts voor orderregels en verzending een korting aanmaken voor een abonnementsproduct, is de korting van toepassing op de volgende betalingen:

alleen de eerste betaling van een bestelling met betaling per bezorging, en niet op geplande bestellingen
het volledige bedrag van een vooruitbetaalde abonnementsbestelling

Meer informatie over abonnementen en scripts.

Versnelde checkouts

Wanneer je Shopify-scripts gebruikt met versnelde checkouts, worden verzendkortingen toegepast nadat je klant een versnelde betaalmethode heeft geselecteerd. Hierdoor worden wijzigingen in de prijs van de bestelling niet weergegeven op het apparaat of in de browser van de klant. Klanten zien de oorspronkelijke prijs in hun versnelde checkout, maar de juiste prijs met korting wordt bij hen in rekening gebracht.

Shopify Point of Sale (POS)

Shopify-scripts werken niet met Shopify Point of Sale (POS).

De naam van betalingsgateways wijzigen

Je kunt de naam van betalingsgateways niet wijzigen als er afbeeldingen of logo's worden weergegeven als de naam van de gateway. De naam van betalingsgateways met een logoafbeelding naast hun naam kan wel worden gewijzigd.

Gesplitste verzending in de checkout

Verzendscripts zijn niet compatibel met gesplitste verzending in Shopify Checkout. Als je verzendscripts gebruikt en gesplitste verzending activeert, worden gesplitste zendingen niet aan je klanten weergegeven bij de checkout.