WordPress

WordPress headless avec Next.js ou thème classique : que choisir ?

Othmane Ibn Dahou Idrissi ·

WordPress fournit le contenu au site public via un thème classique ou une API pour une façade séparée.

Un site WordPress doit être modernisé. L’équipe souhaite une interface rapide et personnalisée ; quelqu’un propose Next.js en façade et WordPress comme simple gestionnaire de contenu. La proposition peut être pertinente, mais elle ne se juge pas sur une démonstration visuelle. Il faut examiner le parcours des rédacteurs, la prévisualisation, les médias, l’hébergement et la responsabilité des mises à jour.

Ce comparatif s’adresse aux développeurs et aux décideurs techniques. Il utilise des situations hypothétiques, sans attribuer de budget, de gain de trafic ou de performance à un client. L’objectif est de choisir l’architecture qui répond aux contraintes du projet, avec une maintenance compréhensible.

Ce qui change lorsque WordPress devient headless

Avec un thème classique, WordPress gère le contenu et produit les pages publiques. Avec une architecture headless, WordPress conserve son rôle éditorial tandis qu’une autre application, ici Next.js, construit le site visible. Les deux systèmes communiquent par une API, par exemple l’API REST native de WordPress.

Thème classique
Rédacteur -> WordPress -> thème -> visiteur

Headless
Rédacteur -> WordPress -> API -> Next.js -> visiteur
                  |                 ^
                  +-- publication --+ invalidation

Cette séparation donne une liberté de composition au frontend, mais crée un contrat entre deux applications. Une modification du modèle de contenu, un changement d’authentification ou une panne de l’API peut désormais affecter cette frontière. Il faut la concevoir comme un produit maintenu, pas comme une simple requête ajoutée à une page.

Commencer par le travail des rédacteurs

Demandez à la personne qui publie un article de montrer son parcours complet : créer, choisir une image, prévisualiser, corriger, programmer et retirer. En headless, le bouton d’aperçu WordPress ne sait pas nécessairement afficher la future page Next.js. Cette intégration doit être prévue, avec un accès privé aux brouillons et des liens qui expirent lorsque c’est nécessaire.

Vérifiez également les blocs utilisés. Un contenu rédigé avec des blocs standards n’a pas les mêmes dépendances qu’une page construite avec un outil visuel et des widgets spécifiques. L’API peut fournir du HTML sans reproduire automatiquement les styles, scripts et interactions du thème d’origine.

Si l’autonomie éditoriale est la priorité, un thème bien conçu avec des champs structurés peut suffire. Le guide sur ACF et la séparation des données de la mise en page aide à distinguer le modèle de contenu du choix d’interface. Changer de frontend ne remplace pas cette réflexion.

Évaluer les bénéfices qui concernent réellement le projet

Next.js peut être intéressant si le site partage des composants React avec une application, compose plusieurs sources de données ou comporte des interactions métier difficiles à intégrer dans un thème. Une équipe déjà capable de maintenir React, TypeScript et un environnement Node réduit aussi le coût d’adoption.

À l’inverse, un site institutionnel de quelques pages avec une équipe éditoriale autonome n’a pas nécessairement besoin de deux applications. Un thème léger, une bonne gestion des images et un hébergement adapté peuvent répondre au besoin. Une architecture plus complexe n’est pas un signe de qualité en soi.

Le headless ne garantit pas le référencement. La façade doit encore livrer le contenu, les redirections, les titres, les canonicals, le sitemap et les images correctement. Elle ne garantit pas non plus la sécurité : WordPress, ses extensions et son administration restent à maintenir, tandis que Next.js ajoute sa propre surface technique.

Concevoir une lecture d’API limitée et explicite

Pour une liste publique, demandez uniquement les champs utiles. L’API REST des articles WordPress expose notamment le titre, le slug, la date et le contenu. Le contrat réel doit être validé à la réception ; le serveur distant reste une entrée externe même lorsqu’il vous appartient.

// Exemple de construction d'une URL côté serveur
const origin = process.env.WORDPRESS_ORIGIN;
if (!origin) throw new Error('Origine WordPress manquante');

const endpoint = new URL('/wp-json/wp/v2/posts', origin);
endpoint.searchParams.set('per_page', '12');
endpoint.searchParams.set('page', '1');
endpoint.searchParams.set('status', 'publish');
endpoint.searchParams.set('_fields', 'id,slug,date_gmt,title,excerpt');

const response = await fetch(endpoint, {
  cache: 'force-cache',
  next: { tags: ['wordpress-posts'], revalidate: 300 },
});
if (!response.ok) throw new Error('WordPress indisponible');
const payload: unknown = await response.json();

Cet extrait suppose WordPress installé à la racine de son origine. Adaptez le chemin si l’installation utilise un sous-répertoire. Il montre le chargement, pas le rendu du HTML. N’injectez pas automatiquement un champ rendered dans dangerouslySetInnerHTML sans définir la provenance, les éléments autorisés et une politique de nettoyage adaptée.

Le cache doit suivre les événements éditoriaux. Une durée de secours ne suffit pas toujours pour une correction urgente. Le guide sur l’invalidation d’un CMS Next.js explique comment relier publication et fraîcheur sans partager les brouillons.

Comparer le coût de maintenance sans inventer un budget

Pour un thème classique, identifiez les responsabilités WordPress : mises à jour, sauvegardes, extensions, PHP, base et médias. Pour une façade Next.js, ajoutez les dépendances JavaScript, le build, le runtime, la surveillance de l’API, la prévisualisation et la stratégie de cache. Ce sont des catégories de travail, pas des montants universels.

Demandez qui intervient lorsqu’un rédacteur publie un article qui n’apparaît pas. Si la réponse traverse trois prestataires sans responsable clair, le problème est déjà architectural. Définissez un propriétaire pour l’ensemble du parcours, même lorsque l’infrastructure est répartie.

L’hébergement compte également. Une offre PHP classique ne garantit pas la disponibilité d’un runtime Node persistant ou d’un déploiement Next.js adapté. Vérifiez les capacités réelles de l’offre et les besoins du mode choisi. Un export statique peut convenir à certains sites, mais il change les possibilités dynamiques et le processus de publication.

Trois situations pour prendre une décision

Premier cas : un site vitrine comporte huit pages, un formulaire et quelques actualités. Les rédacteurs apprécient leur éditeur et les interactions restent simples. Un thème classique correctement structuré constitue une option solide. Le projet doit d’abord démontrer qu’une séparation résout un problème réel.

Deuxième cas : une plateforme combine des articles WordPress, un catalogue externe et un espace utilisateur React. Une façade commune peut simplifier l’expérience et la réutilisation des composants. Il faut cependant distinguer les données publiques, les sessions et les caches privés ; un frontend unique ne rend pas ces sources interchangeables.

Troisième cas : le site dépend de nombreux widgets et extensions qui génèrent leur propre HTML interactif. Une migration headless demande un inventaire de leurs fonctions, pas seulement une exportation d’articles. Le coût peut venir de la reconstruction des parcours plutôt que de la lecture de l’API.

Réaliser une preuve de fonctionnement utile

Avant de valider l’architecture, choisissez un article représentatif avec image, lien, bloc spécifique et aperçu privé. Faites-le publier par une personne qui utilise réellement le CMS. Vérifiez la correction après publication, la programmation, le retrait et l’affichage sur mobile.

Ajoutez un test de panne de WordPress et un contrôle du HTML public. Que voit le visiteur si l’API ne répond pas ? Un ancien contenu acceptable, une erreur explicite ou une page vide ? Cette décision doit être assumée. Mesurez ensuite les performances sur un build comparable ; ne comparez pas une démonstration vide avec un site chargé de contenus réels.

Si le changement implique de nouvelles URL, préparez une migration SEO avec correspondance des redirections avant le lancement. Ce travail reste nécessaire même si la nouvelle interface paraît meilleure.

Questions fréquentes

Peut-on garder WordPress uniquement pour les articles ?

Oui, si le contrat éditorial est clair. Définissez les contenus concernés, leur prévisualisation et leur publication. Évitez de multiplier les gestionnaires de contenu sans savoir où chaque information doit être modifiée.

Le thème classique empêche-t-il une interface moderne ?

Non. La qualité visuelle dépend de la conception et de l’implémentation. React peut être utile pour certaines interactions sans nécessiter une séparation complète du site.

Quelle option choisir sans équipe technique permanente ?

Privilégiez celle dont la maintenance peut être assurée durablement par les personnes disponibles. Faites expliciter les opérations courantes et les incidents possibles. Pour examiner ces contraintes sur un projet précis, vous pouvez utiliser la section contact.

WordPressNext.jsHeadless CMSArchitecture web