Migrar dos Scripts da Shopify para o Shopify Functions

O Shopify Functions é semelhante aos Scripts da Shopify, que permitem aos desenvolvedores criar experiências de comércio personalizadas.

Shopify Plus

Os Scripts da Shopify e o app Script Editor estão disponíveis apenas para lojistas do Shopify Plus. O app Script Editor não está mais disponível para download na Shopify App Store.

Em 28 de agosto de 2025, os Scripts da Shopify serão removidos e não funcionarão mais. Por isso, migre os scripts existentes para o Shopify Functions antes dessa data.

Shopify Functions

O Shopify Functions é instalado como parte de um app. Ele é configurado junto com outros recursos diretamente no admin da Shopify, ou seja, os lojistas não precisam usar código quando estão criando ou modificando personalizações. A plataforma WebAssembly, que executa o Shopify Functions, oferece um desempenho melhor que os Scripts da Shopify e executa códigos em até cinco milissegundos. Isso possibilita que o Shopify Functions aceite grandes eventos de vendas, como vendas-relâmpago, sem diminuição do desempenho.

Com o Shopify Functions, os desenvolvedores podem testar o código e a unidade em seu próprio ambiente local. Além disso, eles distribuem as personalizações do Shopify Functions como parte de um app, em vez de copiar e colar o código Ruby em cada loja. Por último, também há uma redução dos problemas de limitação de tempo e de memória da CPU.

Migrar para o Shopify Functions

Recomenda-se começar a migração pelos apps baseados no Shopify Functions para personalização de entrega ou de pagamento e usá-los junto com scripts de desconto de itens de linha. Quando estiver à vontade com o uso do Shopify Functions para entrega e pagamento, prossiga com o Shopify Functions para descontos.

Etapas:

1. No admin da Shopify, acesse Apps > Script Editor.
2. Analise os scripts existentes. Consulte as tabelas de comparação de descontos, entregas e pagamentos para determinar quais scripts podem ser replicados com uso do Shopify Functions.
3. Se não for possível usar o Shopify Functions para substituir um script, continue com o script até que as APIs do Shopify Functions Shopify ofereçam os recursos necessários.

4. Se for possível substituir um script com o Shopify Functions, siga um destes procedimentos:

   • Consulte na Shopify App Store se há um app disponível publicamente que atenda às necessidades.
   • Se a loja estiver no plano Shopify Plus, é possível criar seu próprio app personalizado baseado no Shopify Functions. Vale lembrar que existem tutoriais disponíveis para criar apps de desconto, personalização de pagamento e personalização de entrega.

5. Depois de identificar um app baseado no Shopify Functions que atenda às suas necessidades, instale-o na loja e faça as configurações correspondentes no admin da Shopify.

6. Teste o app para verificar se ele funciona como previsto. Se o app atender aos requisitos, desative o script que será substituído.

Observação

Os apps baseados no Shopify Functions precisam usar a App Bridge da Shopify, que não é compatível com os apps personalizados criados no admin da Shopify. Portanto, é necessário criar os apps personalizados baseados no Functions com uso do Painel de Parcerias e depois conectá-los à loja.

Usar Scripts da Shopify com Shopify Functions

Os Scripts da Shopify continuarão funcionando nos checkouts personalizados com checkout.liquid e naqueles que fizeram upgrade para a extensibilidade de checkout até 28 de agosto de 2025.

É possível usar os Scripts da Shopify e o Shopify Functions ao mesmo tempo em uma única loja. Se não for possível substituir os scripts pelo uso do Shopify Functions, continue a usá-los até que as APIs do Shopify Functions ofereçam os recursos necessários. Consulte as seções abaixo para saber como ocorre a interação entre os Scripts da Shopify e o Shopify Functions.

Scripts de itens de linha

Os scripts de itens de linha são executados após a conclusão da lógica de desconto da Shopify, que inclui descontos criados pelo Shopify Functions, e podem acessar os valores que foram descontados.

Os scripts podem acessar apenas o primeiro código de desconto aplicado ao checkout e não têm acesso a outros códigos de desconto que possam ter sido usados. Por exemplo, o uso de reject opera no primeiro desconto aplicado ao checkout, sem afetar os demais.

Scripts de frete

Os scripts de frete são executados após as personalizações de entrega criadas pelo Shopify Functions. Vale destacar que eles não funcionam em resultados modificados de renomeação dessas personalizações, mas a operação não é afetada no caso de personalizações que movem ou ocultam.

Scripts de pagamento

Os scripts de pagamento são executados após personalizações de pagamento criadas pelo Shopify Functions. Vale destacar que eles não funcionam em resultados modificados de renomeação dessas personalizações, mas a operação não é afetada no caso de personalizações que movem ou ocultam.