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.

Exigence du forfait

Les scripts Shopify et l’application Script Editor ne sont disponibles que pour les boutiques bénéficiant du forfait Shopify Plus. L’application Script Editor n’est plus disponible au téléchargement depuis le Shopify App Store.

Le 30 juin 2026, Scripts Shopify sera supprimé et cessera de fonctionner. 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 avec le rapport des personnalisations de scripts Shopify

Le rapport des personnalisations de scripts Shopify est une page personnalisée de votre interface administrateur Shopify qui affiche les personnalisations de scripts existantes qui sont actives dans votre boutique. Elle fournit la documentation Shopify Functions ou les liens vers les applications qui peuvent vous aider à recréer les personnalisations.

Les rapports des personnalisations de scripts Shopify sont générés automatiquement. Vous pouvez également exporter votre rapport et l’afficher sous forme de fichier CSV. Vous devez recréer vos personnalisations à l’aide de Shopify Functions avant le 30 juin2026.

Vérifier vos personnalisations

Suivant les scripts dont vous disposez, la page de votre rapport peut contenir des sections pour les personnalisations des passerelles de paiement, des expéditions et des réductions sur les produits.

Chaque section peut inclure le nom, la description et les liens vers les fichiers sources de vos personnalisations de scripts Shopify, les liens vers les applications recommandées créées avec Shopify Functions et propres à vos personnalisations, ainsi que les liens vers les tutoriels Shopify Functions.

Consultez les informations du rapport pour décider si vous souhaitez recréer vos personnalisations avec les options suivantes :

• Créer votre propre solution à l’aide de Shopify Functions
• Installer des applications créées avec Shopify Functions

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.

Recréer vos personnalisations

1. Depuis votre interface administrateur Shopify, cliquez sur Paramètres > Applications et canaux de vente.

2. Cliquez sur Script Editor.

3. Dans la bannière Remplacer vos scripts Shopify, cliquez sur Remplacer les scripts Shopify.

4. Dans chaque section de votre rapport des personnalisations, effectuez l’une des actions suivantes :

   • Pour afficher les personnalisations de scripts Shopify existantes, cliquez sur le nom du script sous le nombre de personnalisations détectées automatiquement.
   • Pour afficher ou installer des applications compatibles correspondant à vos scripts, dans la section Applications recommandées, cliquez sur Installer pour l’application que vous souhaitez utiliser, ou cliquez sur Plus d’applications comme celle-ci pour trouver d’autres applications compatibles.
   • Pour afficher les tutoriels Shopify Functions, dans la section Comment recréer avec Shopify Functions, cliquez sur le lien API de la fonction correspondante.

Une fois que vous avez effectué un test réussi avec une application ou une personnalisation Shopify Functions, vous pouvez désactiver le script que vous remplacez.

Utiliser les scripts Shopify avec Shopify Functions

Les scripts Shopify continueront de fonctionner sur les paiements personnalisés avec checkout.liquid et sur les paiements mis à niveau jusqu’au 30 juin 2026.

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 sont exécutés avant Shopify Functions, ceci incluant les réductions créées par les applications. Les scripts de rubriques ne peuvent pas accéder aux montants escomptés par les fonctions et les applications.

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.