Migrer des scripts Shopify vers Shopify Functions

Les fonctionnalités de Shopify Functions sont similaires à celles des scripts Shopify, qui permettent aux développeurs de créer des expériences commerciales personnalisées.

Shopify Plus

Les scripts Shopify et l’application Script Editor sont réservés aux marchands Shopify Plus.

Le 13 août 2024, les scripts Shopify seront abandonnés et cesseront d’être pris en charge. Migrez vos scripts existants vers Shopify Functions avant cette date.

Shopify Functions

Les fonctionnalités de Shopify Functions doivent être installées dans le cadre d’une application. Elles sont configurées aux côtés d’autres fonctionnalités directement dans votre interface administrateur Shopify, ce qui signifie que les marchands n’ont pas besoin d’utiliser de code lorsqu’ils créent ou modifient des personnalisations. La plateforme WebAssembly, qui exécute Shopify Functions, est plus performante que les scripts Shopify, car elle exécute le code en moins de 5 millisecondes. C’est pourquoi Shopify Functions peut prendre en charge des événements commerciaux de grande ampleur, tels que les ventes flash, sans que cela n’affecte la performance de la boutique.

En utilisant Shopify Functions, les développeurs peuvent coder et effectuer des tests unitaires dans leur propre environnement local. Les développeurs distribuent leurs personnalisations Shopify Functions dans le cadre d’une application plutôt qu’en copiant-collant du code Ruby dans chaque boutique. Pour finir, l’utilisation de Shopify Functions réduit les problèmes de dépassement de délai et de limite de mémoire du processeur.

Migrer vers Shopify Functions

Il est conseillé de débuter la migration vers Shopify Functions avec les applications de personnalisation de la livraison ou du paiement basées sur Shopify Functions, et de les utiliser conjointement aux scripts de réduction appliqués aux rubriques. Lorsque vous serez à l’aise avec les fonctionnalités de Shopify Functions en matière de livraison et de paiement, vous pourrez commencer progressivement à utiliser Shopify Functions pour les réductions.

Étapes :

1. Dans votre interface administrateur Shopify, accédez à Applications > Script Editor.
2. Étudiez vos scripts existants. Consultez les tableaux de comparaison des réductions, des livraisons et des paiements pour déterminer lequel de vos scripts peut être répliqué avec Shopify Functions.
3. S’il n’est pas possible de remplacer un script en utilisant Shopify Functions, continuez à utiliser ce script jusqu’à ce que les API Shopify Functions répondent à vos besoins.

4. S’il est possible de remplacer un script en utilisant Shopify Functions, effectuez l’une des actions suivantes :

   • Consultez l’App Store de Shopify pour déterminer si une application accessible au public répond à vos besoins.
   • Si vous avez fait souscrit le forfait Shopify Plus pour votre boutique, vous pouvez créer votre propre application personnalisée basée sur Shopify Functions. Nous proposons des tutoriels sur la création d’applications pour les réductions, pour la personnalisation du processus de paiement et pour la personnalisation de la livraison.

5. Une fois que vous avez trouvé une application basée sur Shopify Functions qui répond à vos besoins, installez-la sur votre boutique, puis configurez ses paramètres dans l’interface administrateur Shopify.

6. Testez l’application pour vérifier qu’elle se comporte normalement. Si l’application répond à vos exigences, désactivez le script que l’application basée sur Shopify Functions remplace.

Remarque

Les applications basées sur Shopify Functions nécessitent d’utiliser l’App Bridge de Shopify. Les applications personnalisées créées dans l’interface administrateur Shopify ne prennent pas en charge l’App Bridge de Shopify. C’est pourquoi les applications personnalisées basées sur Functions doivent être créées via le tableau de bord partenaire, puis connectées à votre boutique.

Utiliser les scripts Shopify avec Shopify Functions

Pour les pages de paiement qui ont été personnalisées avec checkout.liquid ainsi que pour celles qui ont été mises à niveau vers Checkout Extensibility, les scripts Shopify continueront de fonctionner jusqu’au 13 août 2024.

Vous pouvez utiliser les scripts Shopify et Shopify Functions conjointement dans une même boutique. S’il n’est pas possible de remplacer vos scripts par des scripts Shopify Functions pour le moment, continuez à utiliser les scripts Shopify jusqu’à ce que les API Shopify Functions répondent à vos besoins. Consultez les informations suivantes pour voir comment les interactions entre les scripts Shopify et Shopify Functions se déroulent.

Scripts de rubriques

Les scripts de rubriques ne s’exécutent qu’une fois la logique de réduction de Shopify entièrement déroulée, y compris les réductions créées par Shopify Functions. Les scripts de rubriques peuvent accéder aux montants qui ont été réduits.

Les scripts n’ont accès qu’au premier code de réduction appliqué à la page de paiement ; ils ne peuvent pas accéder aux autres codes de réduction susceptibles d’avoir été utilisés. Par exemple, l’utilisation de reject agit sur la première réduction appliquée lors de la procédure de paiement et n’affecte pas les autres réductions.

Scripts d'expédition

Les scripts d’expédition s’exécutent après les personnalisations de livraison créées par Shopify Functions. Les scripts ne peuvent pas fonctionner sur les résultats des personnalisations de livraison qui ont été renommées, mais ils peuvent agir sur les personnalisations que l’on masque ou déplace.

Scripts de paiement

Les scripts de paiement s’exécutent après les personnalisations de paiement créées par Shopify Functions. Les scripts ne peuvent pas fonctionner sur les résultats des personnalisations de paiement qui ont été renommées, mais ils peuvent agir sur les personnalisations que l’on masque ou déplace.