Migrazione da Shopify Scripts a Shopify Functions

Le funzioni Shopify sono simili agli script Shopify: consentono agli sviluppatori di creare esperienze commerciali personalizzate.

Requisito 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 si può più scaricare dallo Shopify App Store.

Il 28 agosto 2025, Shopify Scripts verrà rimosso e non funzionerà più. Migra gli script esistenti su Shopify Functions prima di questa data.

Shopify Functions

Le funzioni Shopify vengono installate come parte di un'app e configurate insieme ad altre funzionalità direttamente nel tuo pannello di controllo Shopify, il che significa che i merchant non devono utilizzare il codice quando creano o modificano le personalizzazioni. La piattaforma WebAssembly che esegue Shopify Functions offre una performance migliore rispetto a Shopify Scripts, eseguendo codice in meno di 5 millisecondi. Perciò, Shopify Functions può supportare grossi eventi di vendita, come le offerte lampo, senza diminuire le performance.

Utilizzando Shopify Functions, gli sviluppatori possono codificare e unire test nel proprio ambiente locale. Gli sviluppatori distribuiscono le personalizzazioni di Shopify Functions come parte di un'app, anziché copiare e incollare il codice Ruby in ogni negozio. Infine, utilizzando Shopify Functions, vengono ridotti i problemi di timeout e limite di memoria della CPU.

Migrazione a Shopify Functions con il report delle personalizzazioni degli script Shopify

Il report delle personalizzazioni degli script Shopify è una pagina personalizzata nel tuo pannello di controllo Shopify che mostra le personalizzazioni degli script esistenti e attivi nel tuo negozio e fornisce la documentazione su Shopify Functions o i link alle app pertinenti che possono aiutarti a ricreare le personalizzazioni.

I report delle personalizzazioni degli script Shopify vengono generati automaticamente. Puoi anche esportare il report e visualizzarlo come file CSV. Dovrai ricreare le tue personalizzazioni utilizzando Shopify Functions prima del 28 agosto 2025.

Revisione delle personalizzazioni

A seconda degli script di cui disponi, la pagina del tuo report potrebbe contenere sezioni riguardanti le personalizzazioni di Canali di pagamento, Spedizione e Sconti sui prodotti.

Ogni sezione può includere il nome, la descrizione e i link ai file sorgente delle personalizzazioni degli script Shopify, i link alle app consigliate create con Shopify Functions, e specifiche per le tue personalizzazioni, e i link ai tutorial su Shopify Functions.

Esamina le informazioni del report per decidere se desideri ricreare le tue personalizzazioni con le seguenti opzioni:

• Crea la tua soluzione utilizzando Shopify Functions
• Installa le app basate su Shopify Functions

Nota

Le app basate su Shopify Functions richiedono l'utilizzo di App Bridge di Shopify. Le app personalizzate create nel pannello di controllo Shopify non supportano App Bridge di Shopify, pertanto le app personalizzate basate su Shopify Functions devono essere create utilizzando la Partner Dashboard e quindi connesse al tuo negozio.

Ricreare le personalizzazioni

1. Dal pannello di controllo Shopify vai a Impostazioni > App e canali di vendita.

2. Clicca su Script Editor.

3. Nel banner Sostituisci i tuoi script Shopify, clicca su Sostituisci script Shopify.

4. In ogni sezione presente nel report delle personalizzazioni, esegui una delle seguenti operazioni:

   • Per visualizzare le personalizzazioni degli script Shopify esistenti, clicca sul nome dello script sotto il numero delle personalizzazioni rilevate automaticamente.
   • Per visualizzare o installare app compatibili che corrispondono ai tuoi script, nella sezione App consigliate, clicca su Installa per l'app che desideri utilizzare oppure clicca su Altre app simili per trovare altre app compatibili.
   • Per visualizzare i tutorial di Shopify Functions, nella sezione Come ricreare usando Shopify Functions, fare clicca sul link dell'API della funzione pertinente.

Dopo aver eseguito correttamente il test con un'app o una personalizzazione di Shopify Functions, puoi disattivare lo script che stai sostituendo.

Utilizzo di Shopify Scripts con Shopify Functions

Gli script Shopify continueranno a funzionare sui check-out personalizzati con checkout.liquid e sui check-out per i quali è stato effettuato l'upgrade fino al 28 agosto 2025.

Shopify Scripts e Shopify Functions possono essere utilizzati contemporaneamente in un singolo negozio. Se al momento i tuoi script non possono essere sostituiti utilizzando Shopify Functions, continua a utilizzare Shopify Scripts finché le API di Shopify Functions soddisfano le tue esigenze. Per determinare il modo in cui interagiscono Shopify Scripts e Shopify Functions, consulta quanto segue.

Script di voci dell'ordine

Gli script degli articoli vengono eseguiti prima di Shopify Functions, che include gli sconti creati dalle app. Gli script degli articoli non possono accedere agli importi scontati da funzioni e app.

Gli script possono accedere solo al primo codice sconto applicato al check-out e non possono accedere ad altri codici sconto che potrebbero essere stati utilizzati. Ad esempio, il codice reject funziona sul primo sconto applicato al check-out e non influisce sugli altri sconti.

Script di spedizione

Gli script di spedizione si eseguono dopo le personalizzazioni della consegna create da Shopify Functions. Gli script non possono operare sui risultati di ridenominazione della personalizzazione della consegna modificata, ma possono operare sulle personalizzazioni che si spostano o si nascondono.

Script di pagamento

Gli script dei pagamenti si eseguono dopo le personalizzazioni dei pagamenti create da Shopify Functions. Gli script non possono operare sui risultati di ridenominazione della personalizzazione del pagamento modificato, ma possono operare sulle personalizzazioni che si spostano o si nascondono.