# Mettre à jour WooCommerce vers une version majeure

> HPOS, blocs panier et commande, dépréciation de hooks : ce que changent les versions majeures récentes de WooCommerce et l’ordre des vérifications avant de mettre à jour une boutique active.

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

## Réponse directe

> Ouvrez WooCommerce, État avant de lancer quoi que ce soit : la section Base de données indique si la version de la base correspond à celle de l’extension. Après la mise à jour, WooCommerce affiche un bandeau demandant de lancer la mise à jour de la base de données ; lancez-la et attendez sa fin avant de reprendre les commandes. En cas d’anomalie, WooCommerce, État, Journaux garde la trace de l’opération.

## Deux changements majeurs récents, à titre d’exemple

Les versions majeures de WooCommerce ne se limitent pas à des correctifs : elles peuvent changer la façon dont les commandes sont stockées ou dont les pages clés de la boutique sont construites. Deux évolutions récentes l’illustrent bien. Le stockage haute performance des commandes (HPOS), sorti du statut bêta et déclaré stable dans WooCommerce 8.2 en octobre 2023, déplace les données de commande de la table wp_posts vers des tables dédiées. Les blocs panier et commande, par défaut sur les nouvelles installations depuis WooCommerce 8.3 en novembre 2023, remplacent les shortcodes historiques [woocommerce_cart] et [woocommerce_checkout] par des blocs Gutenberg, les shortcodes restant pris en charge en repli.

Je ne détaille pas ces deux sujets ici : chacun a sa propre méthode de bascule, sur les pages dédiées à la migration vers HPOS et au passage aux blocs panier et commande. Cette page couvre la méthode générale à appliquer à toute montée de version majeure de WooCommerce, HPOS et blocs compris ou non.

## Pourquoi une montée de version WooCommerce casse une boutique

- Une extension de paiement ou de livraison qui lit directement les données de commande dans wp_posts au lieu de passer par l’API WooCommerce, et n’a jamais été mise à jour pour fonctionner avec HPOS
- Une personnalisation du tunnel de commande construite sur les anciens shortcodes, qui perd son style ou son comportement une fois la page basculée sur les blocs
- Un hook déprécié ou supprimé entre deux versions majeures, utilisé par une extension ou un développement sur mesure sans que personne ne l’ait revérifié depuis

## Comment je mets à jour WooCommerce sur une boutique active

1. **Sauvegarde complète** — Fichiers et base, avant toute manipulation, avec une attention particulière aux tables liées aux commandes.
2. **Vérification prioritaire des extensions de paiement** — Je contrôle en premier la compatibilité des extensions de paiement et de livraison : ce sont elles qui bloquent entièrement une boutique si elles cassent, contrairement à une extension cosmétique.
3. **Environnement de test avec le tunnel complet** — Je duplique la boutique sur un environnement de test et je passe une commande complète de bout en bout, jusqu’au paiement, avant de valider la nouvelle version.
4. **Vérification des personnalisations du tunnel** — Si le panier ou la commande ont été personnalisés sur les anciens shortcodes, je vérifie leur comportement après mise à jour, en particulier si la boutique bascule aussi sur les blocs panier et commande.
5. **Mise à jour en production** — Une fois le test validé, je mets à jour WooCommerce sur le site réel, à un moment de faible trafic, et je repasse une commande de contrôle immédiatement après.

## Le point de non-retour

> C’est la mise à jour en production sans avoir validé le tunnel de commande complet sur l’environnement de test au préalable. Une extension de paiement qui casse après coup, en production, immobilise la vente en ligne jusqu’à correction, ce qui a un coût direct impossible à rattraper rétroactivement.

## Vérifier après la mise à jour

> Commande de test avec chaque moyen de paiement actif, calcul des frais de livraison, e-mails de confirmation envoyés, et affichage correct des commandes dans l’administration, HPOS activé ou non.

## Pages liées

- **Migrer WooCommerce vers le stockage haute performance des commandes** — Comment activer HPOS sur une boutique existante sans perdre l’historique des commandes. ([/wordpress-woocommerce/migration/stockage-haute-performance-commandes](/wordpress-woocommerce/migration/stockage-haute-performance-commandes))
- **Passer aux blocs de panier et de commande** — Ce que le passage aux blocs Gutenberg change pour les extensions qui personnalisent le tunnel d’achat. ([/wordpress-woocommerce/migration/blocs-panier-commande](/wordpress-woocommerce/migration/blocs-panier-commande))
- **Vérifier la compatibilité des extensions avant une mise à jour** — La méthode pour savoir si un plugin va survivre au passage à la nouvelle version avant de cliquer sur « mettre à jour ». ([/wordpress-woocommerce/mise-a-jour/verifier-extensions-avant-mise-a-jour](/wordpress-woocommerce/mise-a-jour/verifier-extensions-avant-mise-a-jour))
- **Problème de paiement WooCommerce** — Diagnostiquer un moyen de paiement qui échoue ou qui a cessé de fonctionner après une mise à jour. ([/wordpress-woocommerce/probleme-paiement](/wordpress-woocommerce/probleme-paiement))

## FAQ

### Faut-il activer HPOS en même temps que la montée de version majeure ?

Non, ce sont deux décisions distinctes. HPOS s’active volontairement dans les réglages avancés de WooCommerce, avec un mode de synchronisation qui garde les tables dédiées et wp_posts alignées pendant la transition. Je préfère généralement séparer la montée de version et l’activation de HPOS pour isoler les causes en cas de problème.

### Mes anciens shortcodes panier et commande vont-ils cesser de fonctionner ?

Non, les shortcodes restent pris en charge comme solution de repli après le passage aux blocs. Il est même possible de reconvertir un bloc en shortcode depuis la barre d’outils du bloc si une personnalisation en dépend encore.

### Pourquoi vérifier les extensions de paiement en premier ?

Parce qu’un problème de catalogue ou d’affichage laisse la boutique fonctionnelle en dégradé, alors qu’une extension de paiement cassée bloque toute vente jusqu’à correction.

### Une extension WooCommerce compatible avec une ancienne version reste-t-elle compatible avec une version majeure suivante ?

Pas nécessairement. Chaque version majeure peut déprécier ou supprimer des hooks utilisés par l’extension. La compatibilité doit être revérifiée à chaque montée de version majeure, pas seulement lors de la première installation.