# Antipatterns : une variation de styles par client, faute d’un thème paramétrable

> Pourquoi certaines agences multiplient les variations de styles au lieu de concevoir un thème correctement configurable dès le départ, et comment sortir de cette spirale.

- Auteur : Clément Hadrot
- Publié le : 2025-10-18
- Mis à jour le : 2025-10-18
- Catégorie : FSE
- URL : https://wpmoderne.dev.wordpress-developpement.fr/fse/antipattern-variation-styles-par-client-theme-non-parametrable/

## L’essentiel

- Une variation par client, pas par besoin réel
- Le thème n'a jamais été pensé pour varier
- Refactoriser vers des presets réutilisables

Vingt-sept fichiers dans le dossier `styles/` d'un même thème bloc. Vingt-sept variations enregistrées, une par client, chacune redéfinissant intégralement la palette de couleurs, les tailles de police et parfois même les espacements, alors que la structure des templates reste rigoureusement identique d'un projet à l'autre.

## Ce qu'on observe sur le terrain

Le mécanisme des variations de styles a été pensé pour proposer plusieurs identités visuelles cohérentes sur un même thème, chacune couvrant un sous-ensemble de personnalisations pertinentes. Mais dans cette agence, chaque nouveau client reçoit sa propre variation, créée en dupliquant la précédente et en réajustant toutes les valeurs une par une, sans jamais interroger la structure sous-jacente du thème lui-même.

- Chaque variation redéfinit l'intégralité de la section `settings.color.palette`, même quand seules deux couleurs changent réellement.
- Les valeurs de typographie fluide sont recopiées à l'identique dans chaque fichier, sans jamais être factorisées.
- Aucune convention de nommage ne permet de distinguer, dans la liste des vingt-sept fichiers, lesquels sont encore utilisés par un client actif.

## Pourquoi c'est un problème réel

Le thème lui-même n'a jamais été pensé pour accueillir des variations : ses templates référencent des couleurs codées en dur par endroits, plutôt que systématiquement via les variables CSS générées par `theme.json`. Résultat, certaines variations ne suffisent pas à changer complètement l'apparence, et une intervention manuelle dans le code du template devient nécessaire à chaque nouveau client, ce qui annule justement l'intérêt du mécanisme de variation.

> L'essentiel à retenir : Une variation par client, pas par besoin réel ; Le thème n'a jamais été pensé pour varier ; Refactoriser vers des presets réutilisables

Un correctif appliqué au thème de base, par exemple une correction de contraste sur le bloc de citation, doit ensuite être vérifié individuellement sur chacune des vingt-sept variations, puisque plusieurs d'entre elles surchargent la couleur concernée sans que personne ne se souvienne exactement lesquelles.

## Ce qu'un thème correctement paramétrable aurait permis

La bonne pratique consiste à concevoir le thème de base avec un système de presets réellement modulaire dès la conception : des couleurs, des tailles et des espacements exposés comme des `presets` nommés dans `theme.json`, référencés systématiquement dans les templates via `var:preset|color|primaire` plutôt que codés en dur.

```
{
    "settings": {
        "color": {
            "palette": [
                { "slug": "primaire", "color": "#1d3557", "name": "Couleur primaire" },
                { "slug": "secondaire", "color": "#e63946", "name": "Couleur secondaire" }
            ]
        }
    }
}
```

Une variation de styles bien conçue ne redéfinit alors que deux ou trois valeurs de preset, jamais l'intégralité de la structure. Le fichier passe de plusieurs centaines de lignes à une dizaine, et surtout : une correction sur le thème de base se propage automatiquement à toutes les variations, sans vérification individuelle.

## Comment sortir de la spirale une fois installée

Le refactoring ne se fait pas en une seule fois. La méthode consiste à identifier, parmi les vingt-sept variations, celles réellement actives sur un site en production, puis à les réécrire une par une en s'appuyant sur les presets nouvellement structurés dans le thème de base, en commençant par les projets les plus simples pour valider la méthode avant de s'attaquer aux cas complexes.

> Une variation de styles ne devrait jamais être plus longue que les cinq ou six valeurs qui distinguent réellement un client d'un autre : au-delà, c'est le thème qui a un problème, pas la variation.

## Ce qu'on retient

Multiplier les variations de styles par client, sans avoir conçu le thème de base pour réellement les supporter, transforme un mécanisme pensé pour la flexibilité en une source de dette technique silencieuse. La solution ne réside pas dans plus de rigueur au moment de créer chaque variation, mais dans un thème pensé, dès sa conception, autour de presets réellement réutilisables.