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

Si consiglia di iniziare la migrazione a Shopify Functions con le app di personalizzazione del pagamento o della consegna basate su Shopify Functions e di utilizzarle insieme agli script di sconto sulle voci. Una volta che hai acquisito familiarità con l'utilizzo di Shopify Functions per la consegna e il pagamento, puoi andare avanti con l'utilizzo di Shopify Functions per gli sconti.

Procedura:

1. Dal pannello di controllo Shopify vai su App > Script Editor.
2. Controlla gli script esistenti. Consulta le tabelle di confronto sconto, consegna e pagamento per determinare quali script possono essere replicati utilizzando Shopify Functions.
3. Se uno script non può essere sostituito utilizzando Shopify Functions, continua a utilizzarlo finché le API di Shopify Functions soddisfano le tue esigenze.

4. Se uno script può essere sostituito utilizzando Shopify Functions, effettua una delle seguenti operazioni:

   • Consulta Shopify App Store per determinare se un'app pubblicamente disponibile soddisfa le tue esigenze.
   • Se il piano del tuo negozio è Shopify Plus, puoi creare la tua app personalizzata basata su Shopify Functions. I tutorial sono disponibili per la creazione di app per gli sconti, la personalizzazione del pagamento e la personalizzazione delle consegne.

5. Dopo aver identificato un'app basata su Shopify Functions che soddisfi le tue esigenze, installa l'app nel tuo negozio e configura le impostazioni dell'app nel pannello di controllo Shopify.

6. Prova l'app per verificare che funzioni come previsto. Se l'app soddisfa i tuoi requisiti, disattiva lo script che l'app basata su Shopify Functions sta sostituendo.

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.

Utilizzo di Shopify Scripts con Shopify Functions

Shopify Scripts continuerà a funzionare sui check-out personalizzati con checkout.liquid e sui check-out per i quali è stato effettuato l'upgrade a Checkout Extensibility 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.