# Une fonctionnalité s’est cassée après une mise à jour d’extension

> Le site reste accessible, mais une fonction précise s’est arrêtée de fonctionner juste après une mise à jour d’extension ou de thème : un bouton qui ne répond plus, un bloc qui disparaît, une étape du tunnel de commande qui se bloque. C’est un cas différent d’une erreur critique qui met tout le site hors service : ici, deux extensions qui cohabitaient bien se marchent soudain sur les pieds.

- Source canonique : [https://allaux.fr/wordpress-woocommerce/problemes/conflit-extensions-apres-mise-a-jour](https://allaux.fr/wordpress-woocommerce/problemes/conflit-extensions-apres-mise-a-jour)
- Langue : FR
- Dernière mise à jour : 2026-08-03

## Réponse directe

> Passez WP_DEBUG et WP_DEBUG_LOG à true dans wp-config.php, refaites l’action qui échoue, puis lisez les dernières lignes de wp-content/debug.log : le fichier fautif y est nommé. Si rien ne s’y écrit, l’erreur est côté navigateur. Désactivez ensuite toutes les extensions depuis Extensions > Extensions installées et réactivez-les une par une jusqu’au retour de la panne.

## Comment je procède

1. **Activation du journal d’erreurs** — Je passe WP_DEBUG_LOG à true dans wp-config.php pour que toute erreur PHP en lien avec l’action qui casse s’écrive dans wp-content/debug.log.
2. **Reproduction exacte de l’action** — Je reproduis précisément le clic, l’affichage ou l’étape signalée, pour observer si l’erreur est constante ou dépend d’un contexte particulier (rôle utilisateur, appareil, panier).
3. **Lecture du bon type d’erreur** — Une erreur dans la console du navigateur signale un conflit JavaScript, à traiter différemment d’une erreur PHP fatale dans debug.log : les deux demandent une lecture distincte.
4. **Isolation par désactivation ciblée** — Je désactive les extensions suspectes une à une, ou j’utilise un plugin comme Health Check & Troubleshooting pour tester en conditions propres sans affecter les visiteurs du site en production.
5. **Décision sur la correction à apporter** — Une fois la paire fautive identifiée, je corrige la priorité du hook en conflit ou j’évalue s’il faut remplacer l’une des deux extensions.

## Ce que je traite régulièrement

- Un bouton qui fonctionnait très bien ne répond plus après une mise à jour d’extension
- Un bloc Gutenberg ou un shortcode disparaît soudainement de l’affichage
- Une étape précise du tunnel de commande se bloque, alors que le reste du site fonctionne normalement
- Le site reste parfaitement accessible partout ailleurs, aucun message d’erreur critique
- La console du navigateur affiche une erreur JavaScript inconnue, sans rien dans les journaux serveur

## Les causes réelles d’un conflit d’extensions

Trois mécanismes reviennent le plus souvent. Deux extensions accrochent la même action ou le même filtre avec des priorités qui se marchent dessus, et l’ordre d’exécution change après une mise à jour. Un conflit JavaScript survient quand deux extensions chargent chacune une version différente de jQuery, ou le même script deux fois, ce qui casse silencieusement un comportement au clic. Enfin, une erreur PHP de type « cannot redeclare function » peut apparaître, limitée à un seul chemin de code précis, sans jamais toucher le reste du site.

La distinction entre erreur JavaScript et erreur PHP fatale n’est pas un détail : une erreur dans la console du navigateur ne laisse aucune trace dans debug.log, et inversement. Beaucoup de marchands cherchent au mauvais endroit avant même de commencer le diagnostic.

## Un petit conflit à corriger, ou un remplacement à prévoir

> Réordonner une priorité de hook ou patcher un script se règle en quelques heures de débogage. Quand deux extensions ne peuvent tout simplement pas cohabiter durablement, remplacer l’une des deux est une décision à discuter avant de s’engager sur un correctif temporaire.

## Autres sujets liés

- **Erreur critique WordPress** — Quand c’est tout le site qui est hors service, pas une fonction isolée : un diagnostic différent, une urgence différente. ([/wordpress-woocommerce/erreur-critique](/wordpress-woocommerce/erreur-critique))
- **Dépannage urgent** — Une fonction bloquante sur le tunnel de commande justifie souvent une intervention rapide. ([/services/depannage-urgent](/services/depannage-urgent))
- **Développer une extension WooCommerce sur mesure** — Si le remplacement d’une extension du marché devient la meilleure option. ([/wordpress-woocommerce/extension-sur-mesure](/wordpress-woocommerce/extension-sur-mesure))

## FAQ

### Le site reste en ligne, est-ce vraiment grave ?

Ça dépend de la fonction touchée. Un bloc d’affichage cassé peut attendre ; une étape du tunnel de commande bloquée coûte des ventes à chaque minute, même si le reste du site tourne normalement.

### Comment savoir quelle extension est en cause ?

En désactivant les extensions une par une jusqu’à ce que le symptôme disparaisse, ou en isolant l’erreur exacte dans debug.log ou la console du navigateur, qui pointe souvent directement vers le fichier fautif.

### C’est quoi le plugin Health Check & Troubleshooting ?

Un plugin officiel WordPress qui active un mode de dépannage propre, réservé à l’administrateur connecté : je peux désactiver des extensions pour tester sans que les visiteurs du site en voient rien.

### Faut-il changer d’extension si le conflit revient à chaque mise à jour ?

Si le même conflit réapparaît à chaque mise à jour, patcher en boucle coûte plus cher à terme que remplacer l’extension la moins essentielle par une alternative compatible.

### Combien de temps pour isoler ce genre de conflit ?

Une fois l’accès aux logs et à l’administration obtenu, isoler la paire d’extensions en cause prend généralement quelques heures. La correction elle-même dépend de ce qui est réellement en conflit.