Cerințe și limitări pentru scripturile Shopify
Există unele limitări ale scripturilor Shopify pentru a spori securitatea și pentru a vă asigura că scripturile pot rula indiferent de câți clienți folosesc magazinul dumneavoastră la un moment dat. Țineți cont de următoarele restricții dacă dezvoltați scripturi pentru magazinul dumneavoastră Shopify.
Pe această pagină
- Magazin online și Storefront API
- Scripturi publicate
- Numărul maxim de scripturi Shopify
- Comenzi nefinalizate
- Metacâmpuri
- Atribute pentru coș/plată
- Coduri de reducere
- Rânduri
- Tarife de transport
- Monede multiple
- Expresii regulate
- Teme
- Resurse
- Intrare/ieșire
- Timp și aleatorietate
- Limită de caractere pentru script
- Comenzi cu abonament
- Plăți accelerate
- Shopify Point of Sale (POS)
- Redenumirea gateway-urilor de plată
- Expediere divizată la plată
Magazin online și Storefront API
Când creați sau editați un script, alegeți dacă acesta va rula numai în magazinul dumneavoastră online sau în magazinul online și în următoarele aplicații:
- Aplicații personalizate create cu Storefront API, JavaScript Buy SDK sau Mobile Buy SDKs (Android și iOS)
- Aplicații personalizate care generează plăți
- Constructorii de aplicații pentru mobil Tapcart și Plobal Apps
Pentru ca scripturile să funcționeze, site-ul dumneavoastră web trebuie să aibă funcționalitate de coș de cumpărături încorporată, astfel că nu puteți utiliza scripturi cu butoanele de cumpărare sau cu canalul de vânzări Facebook și Instagram by Meta.
Scripturi publicate
Poate fi publicat un singur script per tip de script la un moment dat. De exemplu, puteți publica un script pentru rânduri și un script pentru tarife de transport, dar nu puteți publica două scripturi pentru rânduri în același timp.
Număr maxim de scripturi Shopify
Puteți crea până la 200 de scripturi Shopify.
Comenzi provizorii
Scripturile pentru rânduri, scripturile pentru tarifele de transport și scripturile pentru plăți nu funcționează cu comenzile provizorii sau la plata comenzilor provizorii.
Metacâmpuri
Scripturile Shopify nu pot accesa metacâmpurile.
Atributele coșului/plății
Scripturile Shopify nu pot accesa atributele de coș Shopify Liquid. Puteți adăuga aceste atribute la paginile coșului dumneavoastră pentru a colecta informații suplimentare de la clienții dumneavoastră, dar nu puteți crea un script care le utilizează.
Coduri de reducere
Scripturile pot accesa dacă este aplicat un cod de reducere, valoarea reducerii și tipul de reducere, cum ar fi o sumă fixă, un procentaj sau transportul. Scripturile nu pot accesa modul în care este aplicat codul de reducere, de exemplu, dacă este specific coșului sau specific rândului. Aceasta înseamnă că scripturile nu pot accesa totalurile după aplicarea reducerii sau reducerile automate.
Scripturile pentru rânduri și de expediere care accesează reducerile aplicate unui coș nu sunt compatibile cu combinațiile de reduceri. Metoda .discount_code poate returna un singur cod de reducere. Coșurile care includ mai multe coduri de reducere folosind combinații de reduceri nu sunt acceptate.
Rânduri
Scripturile nu pot adăuga articole în coș și nu pot crește prețul unui articol.
Tarife de transport
Scripturile nu pot crește prețul unui tarif de transport.
Mai multe monede
Este posibil ca scripturile dumneavoastră să nu funcționeze conform așteptărilor cu funcționalitatea pentru mai multe monede. Pentru a vă asigura că scripturile dumneavoastră funcționează pentru coșuri sau plăți care sunt în orice altă monedă decât moneda principală a magazinului dumneavoastră, trebuie să vă migrați scripturile la Shopify Functions.
Expresii regulate
Potrivirea expresiilor regulate nu este acceptată. Dacă creați un script pentru rânduri, atunci este posibil să puteți utiliza una dintre următoarele metode ca soluție alternativă:
- Metoda
split - Metodele
start_withșiend_with - Metoda
include
Teme
Este posibil să fie necesar să vă actualizați tema Liquid pentru a vă accepta scripturile și pentru a evita confuzia clienților. De exemplu, nu toate temele afișează în coș reducerile pentru rânduri. Dacă acesta este cazul dumneavoastră, atunci trebuie să vă editați tema pentru a afișa în coș reducerile pentru rânduri. Aflați mai multe despre tipurile de modificări pe care le puteți aduce temelor dumneavoastră Liquid.
Resurse
Cantitatea de CPU și de memorie disponibile pentru un script este limitată. Resursele rezervate pentru un script depind de dimensiunea coșului și de cantitatea de calcule pe care le necesită scriptul. Shopify urmărește cu atenție aceste limite de resurse pentru a se asigura că acestea nu împiedică scriptul să funcționeze conform intenției.
Când testați un script, consola Script Editor afișează procentajul de resurse alocate pe care le utilizează scriptul.
Intrare/ieșire
Cu câteva excepții, scripturile Shopify nu sunt capabile de intrare/ieșire. Aceasta înseamnă că scripturile nu pot executa solicitări web sau apeluri la baza de date și nu pot obține date de la un utilizator.
Metoda puts poate fi utilizată pentru a afișa text în consolă în aplicația Script Editor.
Timp și caracter aleatoriu
Scripturile nu pot implica calcule aleatorii sau bazate pe timp. Obiectul Time și metoda rand nu pot fi accesate de scripturile Shopify.
Deoarece scripturile se execută de fiecare dată când se recalculează totalul unui coș, scripturile bazate pe timp sau pe generarea de numere aleatorii ar putea avea rezultate imprevizibile sau confuze dacă un client își modifică frecvent coșul. Cu toate acestea, puteți programa rularea scripturilor în timpul evenimentelor folosind aplicația Launchpad.
Limită de caractere pentru script
Puteți crea scripturi cu o lungime de maximum 40.960 de caractere.
Comenzi cu abonament
Dacă scripturile dumneavoastră pentru rânduri și de expediere creează o reducere pentru un produs cu abonament, atunci reducerea se aplică următoarelor plăți:
- numai primei plăți a unei comenzi cu plată pe livrare, fără a se aplica și comenzilor programate
- întregii sume a unei comenzi cu abonament preplătit
Aflați mai multe despre abonamente și scripturi.
Plăți accelerate
Atunci când utilizați scripturi Shopify cu plăți accelerate, reducerile de transport se aplică după ce clientul dumneavoastră selectează o metodă de plată accelerată. Din acest motiv, modificările prețului comenzii nu se reflectă pe dispozitivul sau în browserul clientului. Clienții pot vedea prețul inițial la plata accelerată, dar li se va percepe prețul corect, cu reducere.
Shopify Point of Sale (POS)
Scripturile Shopify nu funcționează cu Shopify Point of Sale (POS).
Redenumirea gateway-urilor de plată
Nu puteți redenumi gateway-urile de plată care au imagini sau sigle afișate ca nume al gateway-ului. Gateway-urile de plată cu imagini de sigle lângă numele lor pot fi redenumite.
Transport în mai multe colete la plată
Scripturile de expediere sunt incompatibile cu transportul în mai multe colete în Shopify Checkout. Dacă utilizați scripturi de expediere și activați transportul în mai multe colete, atunci expedierile defalcate nu sunt afișate clienților dumneavoastră la plată.