Creazione e abilitazione degli script

Per scrivere gli script si utilizza l'API Shopify Scripts. Questa API è una versione del linguaggio di programmazione Ruby, quindi è necessaria esperienza nella programmazione con Ruby. Utilizza Script Editor per creare, modificare, testare e pubblicare gli script.

Requisiti del piano

Gli script Shopify e l'app Script Editor sono disponibili solo per i negozi con un piano Shopify Plus. L'app Script Editor non è più disponibile per il download dallo Shopify App Store.

Il 30 giugno 2026 gli script Shopify verranno rimossi e non funzioneranno più. Se desideri un supporto continuo per i tuoi casi d'uso esistenti degli script Shopify, devi passare a sostituzioni compatibili con Shopify Functions per gli script di pagamento, spedizione o voce esistenti. Scopri di più sulla migrazione dagli script Shopify a Shopify Functions.

Prima di iniziare a scrivere uno script, esamina i diversi tipi di script (voce, spedizione e pagamento) per conoscere i metodi supportati da ciascun tipo. Ad esempio, uno script per le voci non può utilizzare i metodi di spedizione.

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

Canali supportati

Quando crei (o modifichi) uno script, puoi scegliere se eseguirlo solo nel negozio online o nel negozio online e nelle seguenti app:

• App personalizzate create con Storefront API, JavaScript Buy SDK e i Mobile Buy SDK (Android e iOS)
• App personalizzate che generano check-out
• Generatori di app mobili Tapcart, Plobal Apps e Vajro

Nota

Per le installazioni di app che avvengono dopo l'ultimo aggiornamento di uno script, ripubblica lo script per assicurarti che venga eseguito come previsto nel nuovo contesto dell'app.

Puoi trovare esempi di script comuni nei modelli di script forniti in Script Editor. Per visualizzare questi modelli, devi creare uno script.

Crea uno script

Per creare uno script:

Consulta l'API Shopify Scripts come riferimento per la scrittura di codice per gli script.

1. Apri Script Editor. La pagina di panoramica Script mostra un elenco di script per il negozio.
2. Clicca su Crea script per iniziare a creare un nuovo script.
3. Nella finestra di dialogo Seleziona modello di script :
   1. Scegli il tipo di script che desideri creare.
   2. Scegli un modello di esempio come punto di partenza oppure Modello vuoto per iniziare a scrivere uno script da zero.
   3. Clicca su Crea script per creare uno script del tipo scelto.

      Suggerimento

      Il tipo di script che scegli qui (Voci, Tariffe di spedizione o Gateway di pagamento) determina il tipo di script e i metodi che può utilizzare.

4. Nella casella **Titolo** inserisci un nome per lo script. Usa un nome descrittivo in modo da poter capire a colpo d'occhio la funzione dello script. 5. Clicca su **Codice** per aprire la console **Codice sorgente Ruby**. 6. Inserisci il codice per lo script. Utilizza come riferimento la [documentazione dell'API Shopify Scripts](/manual/checkout-settings/script-editor/shopify-scripts). 7. Clicca su **Esegui script** per eseguire lo script. 8. Al termine: * clicca su **Salva bozza** per salvare una bozza non pubblicata dello script; * clicca su **Salva e pubblica** per creare e pubblicare lo script.

Prossimi passaggi

Dopo aver scritto uno script, dovresti testarlo ed eseguirne il debug prima di pubblicarlo. Puoi anche aggiornare i file dei modelli Liquid in modo che la vetrina virtuale risponda alle modifiche apportate dagli script.