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.
Sur cette page
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
Recréer vos personnalisations
Depuis votre interface administrateur Shopify, cliquez sur Paramètres > Applications et canaux de vente.
Cliquez sur Script Editor.
Dans la bannière Remplacer vos scripts Shopify, cliquez sur Remplacer les scripts Shopify.
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.