Guida
Accedi

Requisiti e limitazioni degli script Shopify

Esistono alcune limitazioni per gli script Shopify al fine di migliorare la sicurezza e garantire che gli script possano essere eseguiti indipendentemente dal numero di clienti che utilizzano il negozio in un dato momento. Tieni presenti le seguenti restrizioni se sviluppi script per il negozio Shopify.

In questa pagina

Negozio online e Storefront API

Quando crei o modifichi uno script, scegli se eseguirlo solo nel tuo negozio online oppure nel tuo negozio online e nelle seguenti app:

Affinché gli script funzionino, il tuo sito web deve disporre di una funzionalità di carrello integrata, pertanto non puoi utilizzare gli script con i Buy Button o con il canale di vendita Facebook and Instagram by Meta.

Script pubblicati

È possibile pubblicare un solo script per tipo alla volta. Ad esempio, puoi pubblicare uno script per le voci e uno per le tariffe di spedizione, ma non puoi pubblicare due script per le voci contemporaneamente.

Numero massimo di script Shopify

Puoi creare fino a 200 script Shopify.

Bozze di ordini

Gli script delle voci, gli script delle tariffe di spedizione e gli script dei pagamenti non funzionano con le bozze di ordini o con il check-out delle bozze di ordini.

Metafield

Gli script Shopify non possono accedere a Metafields.

Attributi del carrello/check-out

Gli script Shopify non possono accedere agli attributi del carrello di Liquid. Puoi aggiungere questi attributi alle pagine del carrello per raccogliere informazioni aggiuntive dai clienti, ma non puoi creare uno script che li utilizzi.

Codici sconto

Gli script possono verificare se è stato applicato un codice sconto, l'importo e il tipo di sconto (ad esempio, importo fisso, percentuale o spedizione). Gli script non possono accedere al modo in cui viene applicato il codice sconto, ad esempio se è specifico per il carrello o per la voce. Ciò significa che gli script non possono accedere ai totali al netto degli sconti o agli sconti automatici.

Gli script per voci e spedizione che accedono agli sconti applicati a un carrello non sono compatibili con le combinazioni di sconti. Il metodo .discount_code può restituire un solo codice sconto. I carrelli che includono più codici sconto utilizzando le combinazioni di sconti non sono supportati.

Voci

Gli script non possono aggiungere articoli al carrello né aumentare il prezzo di un articolo.

Tariffe di spedizione

Gli script non possono aumentare il prezzo di una tariffa di spedizione.

Multivaluta

È possibile che gli script non funzionino come previsto con multi-currency. Per assicurarti che gli script funzionino per i carrelli o i check-out in qualsiasi valuta diversa da quella principale del negozio, devi migrare gli script a Shopify Functions.

Espressioni regolari

La corrispondenza tramite espressioni regolari non è supportata. Se stai creando uno script per voci, potresti usare uno dei seguenti metodi come soluzione alternativa:

Temi

Potrebbe essere necessario aggiornare il tema Liquid per supportare gli script ed evitare di confondere i clienti. Ad esempio, non tutti i temi mostrano gli sconti per voci nel carrello. In tal caso, devi modificare il tema per mostrare gli sconti per voci nel carrello. Scopri di più sui tipi di modifiche che puoi apportare ai temi Liquid.

Risorse

La quantità di CPU e memoria disponibile per uno script è limitata. Le risorse riservate per uno script dipendono dalle dimensioni del carrello e dalla quantità di calcoli richiesti dallo script. Shopify traccia attentamente questi limiti di risorse per assicurarsi che non impediscano allo script di funzionare come previsto.

Quando esegui un test su uno script, la console dello Script Editor stampa la percentuale di risorse allocate utilizzata dallo script.

Input/output

Fatte salve alcune eccezioni, gli script Shopify non sono in grado di eseguire operazioni di input/output. Ciò significa che gli script non possono eseguire richieste web o chiamate al database e non possono ricevere input da un utente.

Il metodo puts può essere utilizzato per stampare testo nella console dell'app Script Editor.

Tempo e casualità

Gli script non possono includere calcoli casuali o basati sul tempo. L'oggetto Time e il metodo rand non sono accessibili agli script Shopify.

Poiché gli script vengono eseguiti ogni volta che viene ricalcolato il totale di un carrello, quelli basati sul tempo o sulla generazione di numeri casuali potrebbero avere risultati imprevedibili o creare confusione se un cliente modifica spesso il carrello. Tuttavia, puoi programmare l'esecuzione degli script durante gli eventi utilizzando l'app Launchpad.

Limite di caratteri per gli script

Puoi creare script fino a un massimo di 40.960 caratteri.

Ordini in abbonamento

Se gli script per voci e spedizione creano uno sconto per un prodotto in abbonamento, lo sconto si applica ai seguenti pagamenti:

  • solo al primo pagamento di un ordine pagato per ogni consegna, senza applicarsi agli ordini programmati
  • all'intero importo di un ordine in abbonamento prepagato

Scopri di più su abbonamenti e script.

Check-out veloci

Quando utilizzi gli script Shopify con i check-out veloci, gli sconti sulla spedizione vengono applicati dopo che il cliente ha selezionato un metodo di pagamento veloce. Per questo motivo, le modifiche al prezzo dell'ordine non si riflettono sul dispositivo o sul browser del cliente. I clienti possono visualizzare il prezzo originale nel check-out veloce, ma verrà loro addebitato il prezzo scontato corretto.

Shopify Point of Sale (POS)

Gli script Shopify non funzionano con Shopify Point of Sale (POS).

Ridenominazione dei canali di pagamento

Non puoi rinominare i canali di pagamento che hanno immagini o loghi visualizzati come nome del canale. I canali di pagamento con loghi accanto al nome possono essere rinominati.

Spedizione suddivisa nel check-out

Gli script di spedizione non sono compatibili con la spedizione suddivisa nel check-out di Shopify. Se utilizzi gli script di spedizione e attivi la spedizione suddivisa, le spedizioni suddivise non verranno mostrate ai clienti al check-out.