Vous avez mis à jour votre thème Shopify, ou quelqu’un l’a fait pour vous, et maintenant quelque chose s’affiche ou fonctionne différemment. Une section a peut-être disparu, la mise en page est décalée, une fonctionnalité personnalisée manque ou le panier ne se comporte plus comme avant.
Les symptômes typiques sont :
- des sections ou des blocs personnalisés manquent
- les couleurs, les polices ou les espacements ont changé
- une fonctionnalité ajoutée par un développeur ne fonctionne plus
- un widget d’application, comme les avis ou un guide des tailles, a disparu
- le panier ou le bouton « ajouter au panier » se comporte différemment
- les pages s’affichent bien sur ordinateur mais pas sur mobile
La bonne nouvelle, c’est que dans Shopify une mise à jour de thème ne détruit normalement pas votre ancien thème. Dans la plupart des cas, la version précédente se trouve toujours dans votre bibliothèque de thèmes, et vous pouvez y revenir le temps de comprendre ce qui a changé.
Ce guide explique comment fonctionnent en général les mises à jour de thème, pourquoi les personnalisations ne sont pas toujours reprises, comment restaurer la version précédente en toute sécurité et comment éviter le même problème la prochaine fois.
Comment fonctionnent les mises à jour de thème Shopify ?
Un thème Shopify est un ensemble de templates, de sections, de réglages et de code qui détermine l’apparence et le comportement de votre boutique.
Lorsqu’un thème du Shopify Theme Store dispose d’une nouvelle version, Shopify vous permet généralement d’ajouter la version mise à jour à votre bibliothèque de thèmes plutôt que d’écraser le thème que vous utilisez. Les étapes exactes peuvent varier selon le thème et selon la façon dont Shopify présente les mises à jour à ce moment-là, mais le principe général est le suivant :
- la mise à jour arrive sous la forme d’une nouvelle copie du thème
- les réglages faits dans l’éditeur de thème sont généralement repris lorsque c’est possible
- les modifications faites directement dans le code du thème ne sont généralement pas reprises
- votre thème actuel reste dans la bibliothèque jusqu’à ce que vous le supprimiez
C’est pourquoi une mise à jour peut sembler cassée alors que rien n’a été « perdu » : la nouvelle version ne contient tout simplement pas le code personnalisé qui avait été ajouté à l’ancienne.
Les thèmes achetés ailleurs, ou les thèmes sur mesure créés par un développeur, ne se mettent pas forcément à jour de cette façon. Ils peuvent devoir être mis à jour manuellement, fichier par fichier.
Pourquoi mon thème ne fonctionne-t-il plus après la mise à jour ?
Le code personnalisé n’a pas été repris
Si un développeur, une agence ou une application a modifié les fichiers du thème, ces modifications n’existent que dans l’ancienne version. Exemples courants :
- des sections ou des snippets personnalisés
- des modifications de la page produit ou du panier
- du code de suivi ou d’analytics
- de petites corrections de style
- du code ajouté par une application lors de son installation
La nouvelle version part du code d’origine du développeur du thème, si bien que ces modifications manquent.
Des sections et des réglages ont changé dans la nouvelle version
Les développeurs de thèmes renomment, fusionnent ou suppriment parfois des sections et des réglages d’une version à l’autre. Un réglage sur lequel vous comptiez peut désormais fonctionner autrement ou ne plus exister. Le contenu lié à une section supprimée peut ne plus s’afficher.
Les app embeds et les blocs d’applications doivent être réactivés
Beaucoup d’applications ajoutent des fonctionnalités via des app embeds ou des blocs d’applications dans l’éditeur de thème. Sur une nouvelle version du thème, certains doivent parfois être réactivés ou replacés dans la bonne section.
Les applications plus anciennes qui injectaient du code directement dans les fichiers du thème peuvent ne pas apparaître du tout dans la nouvelle version, car ce code faisait partie de l’ancien thème.
La mise à jour a été publiée immédiatement
Si le thème mis à jour a été publié avant que quelqu’un ne le vérifie, les clients voient les problèmes tout de suite. C’est la raison la plus fréquente pour laquelle une mise à jour de routine devient urgente.
D’abord, déterminez ce qui a changé
Avant de modifier quoi que ce soit d’autre, répondez à ces questions :
- Quand le thème a-t-il été mis à jour, et par qui ?
- La nouvelle version a-t-elle été publiée, ou est-elle encore non publiée ?
- La version précédente est-elle toujours dans votre bibliothèque de thèmes ?
- Qu’est-ce qui est cassé exactement : une page, une section, une fonctionnalité, le panier ?
- Le problème se produit-il sur ordinateur, sur mobile ou sur les deux ?
- L’ancien thème avait-il été personnalisé avec du code, par un développeur ou par des applications ?
Si quelqu’un d’autre a fait la mise à jour, demandez-lui quelle version il a installée et s’il était au courant du code personnalisé de l’ancien thème.
Que pouvez-vous essayer sans risque ?
Allez dans votre bibliothèque de thèmes
Allez dans Online Store → Themes (Boutique en ligne → Thèmes). Vous verrez votre thème actuel (publié) et une bibliothèque d’autres thèmes. Cherchez la version précédente : elle porte souvent le même nom avec un numéro de version ou une date différents.
Prévisualisez la version précédente
Prévisualisez l’ancienne version avant toute action. La prévisualisation ne change pas ce que voient les clients. Vérifiez qu’elle s’affiche et fonctionne toujours comme prévu, y compris le panier.
Publiez la version précédente si nécessaire
Si la boutique est clairement cassée et que l’ancienne version fonctionne, publier l’ancienne version est généralement le moyen le plus rapide de rétablir la boutique pour les clients. Vous pourrez ensuite travailler sur la nouvelle version en toute tranquillité, sans la publier.
Avant de publier, pensez à tout ce que vous avez modifié dans la nouvelle version depuis la mise à jour, comme de nouveaux contenus dans des sections ou de nouveaux réglages. Ces modifications n’existent peut-être pas dans l’ancienne version. Notez-les pour pouvoir les appliquer à nouveau plus tard.
Vérifiez les app embeds et les blocs
Ouvrez l’éditeur du thème auquel il manque une fonctionnalité d’application et vérifiez la section des app embeds. Si l’embed d’une application est désactivé, l’activer peut faire revenir la fonctionnalité. Certaines applications demandent aussi de replacer leur bloc dans une section précise.
Conservez les deux versions
Ne supprimez pas l’ancienne version. Elle contient le code personnalisé qui doit être reporté dans la nouvelle version. Gardez-la dans la bibliothèque jusqu’à ce que la nouvelle version soit complète et testée.
Que faut-il éviter ?
À éviter :
- supprimer l’ancien thème de la bibliothèque
- modifier le code du thème en ligne sans en avoir fait une copie
- installer une autre mise à jour par-dessus une mise à jour défectueuse
- désinstaller des applications pour « faire le ménage » avant de savoir ce qu’elles font
- copier des fichiers de l’ancien thème vers le nouveau sans les comprendre
- supposer que l’ancienne version se mettra de nouveau à jour d’elle-même plus tard
Modifiez une seule chose à la fois et prévisualisez chaque modification avant de publier.
Comment éviter cela la prochaine fois ?
Une mise à jour de thème doit être traitée comme n’importe quelle autre modification d’une boutique en ligne :
- Dupliquez d’abord. Avant de modifier du code ou d’appliquer une mise à jour, faites une copie du thème en ligne. Cela ne coûte rien et vous offre une solution de repli propre.
- Gardez une trace du code personnalisé. Une courte liste de ce qui a été modifié, où et pourquoi, facilite énormément les mises à jour.
- Mettez à jour dans la bibliothèque, pas en ligne. Ajoutez la nouvelle version, laissez-la non publiée et vérifiez-la soigneusement.
- Reportez les personnalisations dans la nouvelle version avant de la publier.
- Testez les parcours importants : page d’accueil, collection, page produit, panier, début du checkout, affichage mobile.
- Publiez à un moment calme et gardez l’ancienne version quelque temps au cas où vous en auriez besoin.
Quand demander une assistance technique ?
Il est conseillé de demander de l’aide lorsque :
- l’ancien thème contient du code personnalisé et vous ne savez pas ce qu’il fait
- le panier, le début du checkout ou les options des produits sont touchés
- des applications qui fonctionnaient n’apparaissent plus
- la version précédente ne figure plus dans la bibliothèque
- vous avez besoin des fonctionnalités de la nouvelle version mais aussi de vos anciennes personnalisations
- le thème a été créé sur mesure ou ne provient pas du Theme Store
- vous avez déjà essayé quelques modifications et ne savez plus dans quel état se trouve le thème
Vous n’avez pas besoin de savoir exactement ce qui est cassé avant de demander de l’aide.
Quelles informations rassembler ?
Les informations utiles comprennent :
- l’URL de votre boutique
- le nom du thème et les numéros de l’ancienne et de la nouvelle version
- quand la mise à jour a été faite et par qui
- si la nouvelle version est publiée
- ce qui est cassé, avec des captures d’écran
- la liste des personnalisations connues et des applications qui interagissent avec le thème
Si quelqu’un doit travailler sur votre thème, ajoutez-le comme membre du personnel ou collaborateur depuis l’admin Shopify. N’envoyez pas votre mot de passe administrateur par e-mail.
Comment D4Hub peut vous aider
D4Hub peut vous aider à :
- identifier la dernière version fonctionnelle et la restaurer en toute sécurité
- comparer l’ancienne et la nouvelle version du thème pour retrouver le code personnalisé
- reporter les personnalisations dans la nouvelle version
- réactiver et replacer les app embeds et les blocs d’applications
- tester la page produit, le panier et le début du checkout sur la nouvelle version
- documenter vos personnalisations pour faciliter les prochaines mises à jour
- mettre en place une procédure plus sûre pour les mises à jour de thème
Vous pouvez demander de l’aide à tout moment, que vous ayez seulement besoin de retrouver la bonne version ou que vous souhaitiez confier toute la mise à jour.
Ouvrir un ticket de supportPour les utilisateurs expérimentés : comparer et restaurer des versions de thème
Ces étapes s’adressent aux utilisateurs à l’aise avec l’éditeur de thème et l’éditeur de code de Shopify. Travaillez toujours sur une copie, jamais sur le thème en ligne, et gardez l’ancienne version jusqu’à ce que la nouvelle soit entièrement testée.
Dupliquez avant toute chose
Dans Online Store → Themes (Boutique en ligne → Thèmes), utilisez le menu d’actions de votre thème en ligne pour le dupliquer. Faites de même avec toute version que vous vous apprêtez à modifier. Une copie est votre filet de sécurité.
Vous pouvez aussi télécharger une copie des fichiers d’un thème depuis le menu d’actions du thème. Shopify envoie le fichier par e-mail au compte, ce qui vous donne une copie hors ligne.
Retrouvez le code personnalisé dans l’ancienne version
Ouvrez l’éditeur de code de l’ancienne version (depuis le menu d’actions du thème, choisissez de modifier le code). Cherchez :
- les fichiers qui n’existent pas dans la nouvelle version, souvent dans les dossiers sections et snippets
- les fichiers dont le nom fait référence à une application ou à une fonctionnalité personnalisée
- les modifications récentes : l’éditeur de code permet de consulter les anciennes versions d’un fichier, ce qui aide à repérer ce qui a été modifié
Dressez la liste des fichiers et des modifications trouvés avant de déplacer quoi que ce soit.
Comparez les fichiers entre les versions
Pour une comparaison plus fiable, téléchargez les deux versions et comparez les fichiers sur votre ordinateur avec un outil de comparaison de fichiers. Les développeurs qui utilisent Shopify CLI peuvent récupérer chaque thème en local pour les comparer. Les différences dans les fichiers dont vous savez qu’ils ont été personnalisés sont celles à reporter.
Ne copiez pas des fichiers entiers de l’ancienne version vers la nouvelle. Un fichier peut aussi contenir des modifications du développeur du thème dont la nouvelle version dépend. Copiez uniquement les parties personnalisées, et prévisualisez après chaque modification.
Vérifiez les app embeds et les blocs
Sur la nouvelle version, ouvrez l’éditeur de thème et :
- Vérifiez la section des app embeds et activez les embeds dont vos applications ont besoin.
- Vérifiez les sections où apparaissaient des blocs d’applications et ajoutez-les de nouveau si nécessaire.
- Prévisualisez la page produit, le panier et toutes les pages où des applications affichent du contenu.
Testez avant de publier
Prévisualisez la nouvelle version et testez :
- la page d’accueil, une page de collection et une page produit
- les options et les variantes des produits
- l’ajout au panier, la page ou le tiroir du panier et le début du checkout
- l’affichage mobile et sur ordinateur
- toute fonctionnalité qui reposait sur du code personnalisé ou des applications
Ne publiez que lorsque tout cela fonctionne. Gardez l’ancienne version dans la bibliothèque pendant quelque temps après.
Questions fréquentes
La mise à jour a-t-elle supprimé mon ancien thème ?
En général, non. Pour les thèmes du Shopify Theme Store, la mise à jour est normalement ajoutée comme une version distincte dans votre bibliothèque de thèmes, et l’ancienne version y reste sauf si quelqu’un la supprime.
Pourquoi mes personnalisations ont-elles disparu ?
Les modifications faites directement dans le code du thème ne sont généralement pas reprises dans une nouvelle version du thème. Les réglages faits dans l’éditeur de thème le sont généralement, lorsque la nouvelle version les prend en charge.
Puis-je simplement revenir à l’ancienne version ?
Dans la plupart des cas, oui. Prévisualisez la version précédente, vérifiez qu’elle fonctionne et publiez-la. Notez d’abord les modifications que vous avez faites dans la nouvelle version, car elles n’existent peut-être pas dans l’ancienne.
Faut-il vraiment mettre à jour mon thème ?
Les mises à jour peuvent apporter des corrections, de nouvelles fonctionnalités et la compatibilité avec les évolutions de Shopify : il vaut donc la peine de garder ses thèmes raisonnablement à jour. L’approche la plus sûre consiste à mettre à jour dans la bibliothèque, à reporter les personnalisations et à tester avant de publier.
Le widget de mon application a disparu après la mise à jour. L’application est-elle cassée ?
Probablement pas. Vérifiez les app embeds et les blocs d’applications dans l’éditeur de thème de la nouvelle version. Certaines applications doivent être réactivées ou replacées après un changement de thème.
D4Hub peut-il mettre à jour mon thème sans perdre mes personnalisations ?
D4Hub peut comparer les versions, reporter votre code personnalisé et tester la nouvelle version avant sa mise en ligne. L’objectif est que vos clients ne voient le thème mis à jour que lorsqu’il fonctionne comme prévu.