# Surcharge de gabarit

> Le remplacement d'un gabarit fourni par le thème parent ou une extension, en plaçant un fichier de même nom à un emplacement prioritaire.

- Auteur : Clément Hadrot
- Publié le : 2026-09-25
- Mis à jour le : 2026-09-25
- URL : https://wpmoderne.dev.wordpress-developpement.fr/lexique/surcharge-de-gabarit/

Modifier directement les fichiers d'un thème parent ou d'une extension expose à tout perdre à la prochaine mise à jour : la surcharge de gabarit évite ce piège en exploitant l'ordre de priorité que WordPress applique déjà pour choisir ses fichiers de rendu.

## Mécanisme dans un thème enfant

Un fichier placé dans le dossier du thème enfant, portant exactement le même nom que son équivalent dans le thème parent (par exemple `archive.php`), est automatiquement préféré par WordPress lors de la résolution de la hiérarchie des gabarits, sans qu'aucune configuration supplémentaire ne soit nécessaire.

## Surcharger un gabarit d'extension

```
// Copier le gabarit d'une extension dans son propre thème
// depuis : wp-content/plugins/mon-extension/templates/produit.php
// vers   : wp-content/themes/mon-theme/mon-extension/produit.php
```

De nombreuses extensions (WooCommerce en particulier) documentent explicitement ce chemin de recherche, permettant de personnaliser leurs gabarits sans modifier le code source de l'extension elle-même.

## Pièges fréquents

- Une surcharge oubliée après une mise à jour majeure de l'extension d'origine peut afficher un gabarit obsolète, incompatible avec de nouvelles fonctionnalités ajoutées entre-temps.
- Dans un thème bloc, la surcharge se fait au niveau des fichiers de `templates/` et `parts/` du thème enfant, avec une logique de priorité équivalente mais un mécanisme de résolution distinct de celui des thèmes classiques.
- Toute surcharge n'est pas forcément voulue : un fichier mal nommé dans un thème enfant peut remplacer involontairement un gabarit du parent sans que l'auteur s'en aperçoive immédiatement.