Checklist avant de figer functions.php d’un thème qu’on ne fera plus évoluer

Que reste-t-il à savoir sur un thème une fois décidé qu’il ne recevra plus aucune évolution fonctionnelle, seulement des correctifs de sécurité en cas d’urgence ? Cette question se pose systématiquement quand une agence bascule un projet en maintenance minimale, à la demande d’un client dont le budget ne couvre plus que la sécurité de base. Le risque, dans cette transition, est de figer un functions.php mal documenté, dont plus personne ne comprendra le fonctionnement le jour où un correctif urgent sera malgré tout nécessaire.

Cette checklist ne concerne pas une migration vers un thème bloc : elle s’applique à un thème classique qui reste en l’état, sans réécriture, mais dont l’équipe doit sécuriser la compréhension avant de s’en détourner durablement.

Les cinq premiers points : comprendre avant de figer

1. Lister chaque hook actif dans functions.php, avec une ligne de commentaire expliquant son rôle métier, pas seulement sa mécanique technique. Un hook add_filter( 'the_content', … ) sans commentaire ne dira rien, dans deux ans, sur la raison pour laquelle il modifie le contenu.
2. Identifier les dépendances externes appelées depuis le thème : API tierces, services de paiement, outils d’analytics. Chaque appel doit être noté avec l’identifiant de compte ou de clé utilisé, souvent oublié une fois le projet mis de côté.
3. Verrouiller les versions de PHP et de WordPress testées au moment du gel, dans un fichier MAINTENANCE.md versionné avec le thème, pour savoir précisément jusqu’à quelle version l’ensemble a été validé.
4. Vérifier l’absence de fonctions PHP dépréciées dans le code du thème, avec un outil comme wp-cli associé au plugin PHP Compatibility Checker, pour anticiper une éventuelle montée de version imposée par l’hébergeur.
5. Documenter les personnalisations sensibles à la sécurité : tout code qui touche à l’authentification, aux capacités utilisateur via current_user_can(), ou à la validation de formulaires, doit être repéré et commenté en priorité, car ce sont ces zones qui justifieront un correctif d’urgence.

Les trois derniers points : nettoyer et prévoir la suite

1. Retirer le code mort déjà identifié, plutôt que de le figer avec le reste : un bloc de code commenté ou une fonction jamais appelée n’a aucune raison de survivre au gel, et allège la lecture du fichier pour la suite.
2. Établir la liste des extensions dont dépend le thème, avec leur version exacte au moment du gel, pour savoir si une mise à jour future d’une extension casse une intégration prévue dans functions.php.
3. Définir un point de sortie explicite : à quelles conditions cette maintenance minimale prendrait-elle fin, et redeviendrait-elle une maintenance évolutive ? Cette clause, souvent absente du contrat, évite une ambiguïté future sur ce que le client peut ou non attendre de l’agence.

Pourquoi cette documentation dépasse le simple confort

Un functions.php figé sans documentation devient, avec le temps, un objet que plus personne dans l’agence ne souhaite ouvrir : chaque intervention future, même mineure, nécessite alors un temps de réappropriation coûteux, non anticipé au moment du passage en maintenance minimale. Le temps investi dans cette checklist, généralement une demi-journée pour un thème de taille moyenne, se rembourse dès le premier correctif de sécurité urgent réclamé des mois plus tard.

Le format du fichier MAINTENANCE.md

# Maintenance minimale — Thème Client X

Gelé le : 2025-11-21
Version WordPress validée : 6.7
Version PHP validée : 8.2

## Hooks actifs
- after_setup_theme : déclare les supports du thème
- wp_enqueue_scripts : charge les styles et scripts propres au thème
- the_content (filter) : ajoute un encart de partage social en fin d'article

## Dépendances externes
- API de la banque X pour le formulaire de don (clé en variable d'environnement)

## Point de sortie
Reprise d'une maintenance évolutive possible sur nouveau devis,
sans engagement de délai de la part de l'agence.

Un thème gelé sans documentation n’est pas stable : il est simplement devenu incompréhensible plus lentement que s’il continuait d’évoluer.

Notre verdict

Figer un functions.php sans passer par cette checklist revient à reporter le problème plutôt qu’à le régler : la maintenance minimale reste un engagement, pas un abandon, et elle mérite une documentation à la hauteur de ce qu’elle promet. Les huit points de cette liste, appliqués systématiquement, transforment un gel de projet en décision maîtrisée plutôt qu’en zone d’ombre pour la prochaine personne qui devra y toucher.