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.