En bref
Quand le panier WooCommerce ne fonctionne plus, le coupable le plus fréquent est le cache : la page Panier est servie sous forme de copie figée, la même pour tout le monde. Le premier geste consiste à vider tous les caches, puis à vérifier que les pages Panier, Commande et Mon compte en sont bien exclues.
Un client clique sur « Ajouter au panier » et rien ne se passe. Parfois le bouton tourne sans fin, parfois le produit semble ajouté mais la page Panier reste vide, et plus aucune commande n’aboutit. Le plus souvent, WooCommerce lui-même n’est pourtant pas en cause : c’est son environnement (cache, extensions, thème, réglages) qui l’empêche de fonctionner. Ce guide vous aide à trouver la cause, et si le temps presse, notre service de dépannage WooCommerce peut prendre le relais à distance.
Pourquoi le panier WooCommerce ne fonctionne plus ?
Le contenu d’un panier change pour chaque visiteur, à chaque clic. Tout ce qui fige ou perturbe une page peut donc le casser. Voici les causes, de la plus fréquente à la plus rare.
- La page Panier est mise en cache. Le cache est une copie toute prête des pages, gardée pour les afficher plus vite. WooCommerce demande d’en exclure les pages Panier, Commande et Mon compte, car elles affichent des informations propres à chaque client.
- Un CDN ou le cache du serveur. Un CDN est un réseau de serveurs qui garde des copies de votre site pour les distribuer plus vite (Cloudflare, par exemple). Lui, ou le cache de l’hébergeur, peut resservir un panier périmé.
- Un conflit JavaScript. Le JavaScript est le langage qui fait réagir les boutons sans recharger la page. Une erreur dans le script d’une extension ou du thème peut bloquer celui de l’ajout au panier.
- Le mini-panier ne se met plus à jour. Le petit panier de l’en-tête s’actualise grâce aux « fragments de panier », un script de WooCommerce. Depuis la version 7.8, ce script n’est chargé que sur les pages qui affichent le widget de mini-panier, et certains thèmes qui comptaient dessus montrent depuis un compteur faux.
- Les cookies et la session. Un cookie est un petit fichier déposé dans le navigateur ; WooCommerce s’en sert pour retrouver le panier du visiteur, enregistré sur le serveur dans une session. Si ce cookie est bloqué ou mis en cache, ou si le site jongle entre deux adresses (avec et sans www, en http et en https), le panier se vide d’une page à l’autre.
- Des pages mal déclarées. Après une refonte, la page déclarée comme panier dans les réglages n’est parfois plus la bonne, ou ne contient plus le bloc du panier.
Comment réparer le panier WooCommerce étape par étape
Faites d’abord une sauvegarde complète de votre site, fichiers et base de données compris. Suivez ensuite les étapes dans l’ordre et testez le panier après chacune : dès que tout refonctionne, inutile d’aller plus loin.
1. Testez dans une fenêtre de navigation privée
Ouvrez votre boutique en navigation privée, ajoutez un produit et affichez le panier, puis refaites l’essai depuis votre téléphone, en 4G. Si le panier fonctionne ailleurs que sur votre ordinateur, la panne vient de votre navigateur (vieux cookies, extension de blocage) et non du site.
2. Videz tous les caches
Videz le cache de votre extension (WP Rocket, LiteSpeed Cache ou une autre), puis celui de votre hébergeur s’il en propose un dans votre espace client, et enfin celui du CDN. Si le panier refonctionne, passez quand même à l’étape suivante, sinon la panne reviendra.
3. Excluez du cache les pages et les cookies du panier
Dans les réglages de votre extension de cache, vérifiez que les pages Panier, Commande et Mon compte sont exclues du cache, ainsi que les visiteurs porteurs des cookies woocommerce_cart_hash, woocommerce_items_in_cart et wp_woocommerce_session_. La documentation de WooCommerce sur les extensions de cache en donne la liste complète. Certaines extensions s’en chargent seules, comme WP Rocket qui exclut automatiquement ces trois pages. Appliquez la même règle à votre CDN.
4. Vérifiez les pages déclarées dans WooCommerce
Dans WooCommerce > Réglages > Avancé, la « Page panier » et la « Page de commande » doivent désigner les bonnes pages, et des pages publiées. Celles-ci doivent contenir le bloc du panier (ou de la commande) ou le code court correspondant, une balise entre crochets : Choisissez la durée et le niveau d'urgence de votre intervention : la réservation se fait en quelques clics.
Si l’ajout échoue seulement depuis la page boutique, décochez dans l’onglet Produits « Activer les boutons AJAX d’ajout au panier sur les archives » le temps du diagnostic : le bouton redevient un simple lien, moins élégant mais fiable.
5. Contrôlez l’adresse de votre site
Dans Réglages > Général, l’« Adresse web de WordPress (URL) » et l’« Adresse web du site (URL) » doivent être identiques, avec le même https et le même www. Les autres variantes de l’adresse doivent rediriger vers celle-ci, sinon le cookie du panier se perd en route. Voyez aussi notre article sur l’importance du HTTPS.
6. Cherchez une erreur dans la console du navigateur
Sur la page où le bouton ne réagit pas, ouvrez la console du navigateur, la fenêtre qui affiche les erreurs des scripts : dans Chrome, Ctrl + Maj + J sous Windows ou Cmd + Option + J sur Mac. Cliquez sur « Ajouter au panier ». Le message rouge qui apparaît alors contient souvent un chemin de fichier, comme /plugins/nom-de-l-extension/, qui trahit l’extension ou le thème fautif.
7. Faites un test de conflit sur une copie du site
Sur une copie de test de votre boutique (une préproduction, que beaucoup d’hébergeurs créent en quelques clics), suivez la méthode de test de conflit de WooCommerce : désactivez toutes les extensions sauf WooCommerce et passez sur un thème par défaut comme Storefront. Si le panier refonctionne, réactivez les extensions une par une en testant à chaque fois. Celle qui ramène la panne est la coupable.
8. Effacez les sessions clients en dernier recours
Si des paniers fantômes s’affichent, l’outil « Effacer les sessions clients », dans WooCommerce > État > Outils, remet tout à zéro, mais il vide aussi le panier des clients en train d’acheter. Réservez-le à une heure creuse.
À éviter
- Désactiver le cache sur tout le site : la boutique devient lente et le vrai réglage reste à faire.
- Faire le test de conflit sur la boutique en ligne, en pleine journée et sans sauvegarde.
- Modifier les fichiers du thème ou de WooCommerce : la prochaine mise à jour effacera tout.
- Empiler deux extensions de cache, dont les réglages se contredisent.
Ce que nous voyons le plus souvent
Très souvent, la panne suit l’installation d’une extension de cache, l’activation d’un CDN ou un changement d’hébergeur, avec des réglages par défaut qui mettent toutes les pages en cache. Autre situation fréquente : une refonte au cours de laquelle la page Panier a été recréée, alors que WooCommerce pointe encore vers l’ancienne. Les options d’optimisation qui retardent le chargement des scripts cassent aussi volontiers le bouton d’ajout au panier, sans aucun message visible.
Quand faire appel à un professionnel ?
Certaines situations justifient de passer la main sans attendre :
- votre boutique ne prend plus aucune commande et chaque heure vous coûte des ventes ;
- la console affiche des erreurs que vous ne savez pas relier à une extension, ou le test de conflit ne désigne aucun coupable ;
- le panier fonctionne sur la copie de test mais pas en ligne, signe d’un cache serveur ou d’un réglage d’hébergement ;
- vos clients voient le panier d’autres personnes, ce qui pose aussi une question de confidentialité ;
- vous remarquez des redirections ou des scripts inconnus : il faut alors vérifier si votre site a été piraté.
En conclusion :
Un panier WooCommerce qui ne fonctionne plus est le plus souvent une histoire de cache, de script en conflit ou de pages mal déclarées. En avançant dans l’ordre, sauvegarde faite, vous isolerez la cause sans risquer d’aggraver la panne. Si vous préférez confier le problème, notre équipe de dépannage WooCommerce s’en charge à distance, et notre service de dépannage WordPress urgent intervient en priorité quand la boutique est à l’arrêt.
