Créer un Blog WordPress Headless en 30 Minutes (Tutoriel Complet)
Introduction
Dans ce tutoriel, vous allez créer votre premier blog WordPress Headless de A à Z en seulement 30 minutes. À la fin, vous aurez un blog ultra-rapide déployé gratuitement sur Vercel.
Prérequis :
- Connaissance basique de JavaScript
- Node.js installé
- Un compte WordPress (peut être gratuit sur wordpress.com)
- 30 minutes de temps
Ce que vous allez construire :
- Backend WordPress pour gérer le contenu
- Frontend Next.js ultra-rapide
- Déploiement automatique sur Vercel
Allez, c’est parti ! ⚡
Étape 1 : Préparer WordPress (5 minutes)
Activer l’API REST
L’API REST est activée par défaut dans WordPress, vérifions :
- Allez dans Settings → Permalinks
- Sélectionnez Post name
- Cliquez Save Changes
Tester l’API
Dans votre navigateur, visitez :
https://votre-site.com/wp-json/wp/v2/posts
Vous devriez voir du JSON. ✅
Créer du Contenu de Test
- Posts → Add New
- Créez 3 articles rapides
- Ajoutez des images à la une
- Assignez des catégories
- Publish
Étape 2 : Créer le Projet Next.js (10 minutes)
Initialiser le Projet
npx create-next-app@latest mon-blog-headless
cd mon-blog-headless
Répondez aux questions :
✔ Would you like to use TypeScript? No
✔ Would you like to use ESLint? Yes
✔ Would you like to use Tailwind CSS? Yes
✔ Would you like to use `src/` directory? No
✔ Would you like to use App Router? Yes
✔ Would you like to customize the default import alias? No
Installer Axios
npm install axios
Créer le Service API
Créez lib/api.js :
import axios from 'axios';
const API_URL = 'https://votre-site.com/wp-json/wp/v2';
export async function getPosts() {
const response = await axios.get(`${API_URL}/posts?_embed`);
return response.data;
}
export async function getPost(slug) {
const response = await axios.get(`${API_URL}/posts?slug=${slug}&_embed`);
return response.data[0];
}
export async function getCategories() {
const response = await axios.get(`${API_URL}/categories`);
return response.data;
}
Étape 3 : Créer la Page d’Accueil (5 minutes)
Remplacez app/page.js :
import { getPosts } from '@/lib/api';
import Link from 'next/link';
import Image from 'next/image';
export default async function Home() {
const posts = await getPosts();
return (
<div className="max-w-6xl mx-auto px-4 py-8">
<h1 className="text-4xl font-bold mb-8">Mon Blog Headless</h1>
<div className="grid md:grid-columns-3 gap-8">
{posts.map((post) => {
const featuredImage = post._embedded?.['wp:featuredmedia']?.[0]?.source_url;
return (
<article key={post.id} className="border rounded-lg overflow-hidden hover:shadow-lg transition">
{featuredImage && (
<Image
src={featuredImage}
alt={post.title.rendered}
width={400}
height={250}
className="w-full h-48 object-cover"
/>
)}
<div className="p-6">
<h2 className="text-2xl font-bold mb-2">
<Link href={`/blog/${post.slug}`} className="hover:text-blue-600">
{post.title.rendered}
</Link>
</h2>
<div
className="text-gray-600 mb-4"
dangerouslySetInnerHTML={{ __html: post.excerpt.rendered }}
/>
<Link
href={`/blog/${post.slug}`}
className="text-blue-600 font-semibold hover:underline"
>
Lire la suite →
</Link>
</div>
</article>
);
})}
</div>
</div>
);
}
Étape 4 : Créer la Page Article (5 minutes)
Créez app/blog/[slug]/page.js :
import { getPost } from '@/lib/api';
import Image from 'next/image';
export default async function BlogPost({ params }) {
const post = await getPost(params.slug);
if (!post) {
return <div>Article non trouvé</div>;
}
const featuredImage = post._embedded?.['wp:featuredmedia']?.[0]?.source_url;
const author = post._embedded?.author?.[0]?.name;
const date = new Date(post.date).toLocaleDateString('fr-FR');
return (
<article className="max-w-4xl mx-auto px-4 py-8">
{featuredImage && (
<Image
src={featuredImage}
alt={post.title.rendered}
width={1200}
height={630}
className="w-full h-96 object-cover rounded-lg mb-8"
/>
)}
<h1 className="text-5xl font-bold mb-4">
{post.title.rendered}
</h1>
<div className="text-gray-600 mb-8">
Par {author} • {date}
</div>
<div
className="prose prose-lg max-w-none"
dangerouslySetInnerHTML={{ __html: post.content.rendered }}
/>
</article>
);
}
export async function generateMetadata({ params }) {
const post = await getPost(params.slug);
return {
title: post.title.rendered,
description: post.excerpt.rendered.replace(/<[^>]*>/g, '').substring(0, 160),
};
}
Étape 5 : Tester en Local (2 minutes)
npm run dev
Visitez http://localhost:3000
Vous devriez voir vos articles ! 🎉
Étape 6 : Déployer sur Vercel (3 minutes)
Push sur GitHub
git init
git add .
git commit -m "Initial commit - Blog WordPress Headless"
git branch -M main
git remote add origin https://github.com/votre-username/mon-blog.git
git push -u origin main
Déployer
- Allez sur vercel.com
- Connectez-vous avec GitHub
- New Project
- Sélectionnez votre repo
- Deploy
Attendez 2 minutes… Boom ! Site en ligne ! 🚀
Optimisations Bonus
1. Ajouter le Cache ISR
Dans app/page.js, ajoutez :
export const revalidate = 60; // Revalider toutes les 60 secondes
2. Optimiser les Images
Next.js optimise automatiquement, mais vous pouvez :
import Image from 'next/image';
<Image
src={imageUrl}
alt={title}
width={1200}
height={630}
priority // Pour images above-the-fold
placeholder="blur" // Effet de chargement
/>
3. Ajouter Google Analytics
Créez app/layout.js :
import Script from 'next/script';
export default function RootLayout({ children }) {
return (
<html>
<body>
{children}
<Script src="https://www.googletagmanager.com/gtag/js?id=GA_ID" />
<Script id="google-analytics">
{`
window.dataLayer = window.dataLayer || [];
function gtag(){dataLayer.push(arguments);}
gtag('js', new Date());
gtag('config', 'GA_ID');
`}
</Script>
</body>
</html>
);
}
Problèmes Courants
Erreur CORS
Si vous voyez « CORS policy error » :
Solution : Installez le plugin WordPress « WP REST API CORS »
Images ne s’affichent pas
Ajoutez dans next.config.js :
module.exports = {
images: {
domains: ['votre-site.com'],
},
}
Build échoue
Vérifiez que l’API WordPress est accessible publiquement.
Prochaines Étapes
Maintenant que vous avez un blog fonctionnel, vous pouvez :
- 📧 Ajouter les commentaires (Disqus ou API WordPress)
- 🔍 Ajouter la recherche
- 🏷️ Filtrer par catégories
- 📱 Ajouter une newsletter
- 🎨 Personnaliser le design
Conclusion
En 30 minutes, vous avez :
- ✅ Configuré WordPress comme CMS
- ✅ Créé un frontend Next.js moderne
- ✅ Déployé gratuitement sur Vercel
- ✅ Un blog ultra-rapide et scalable
Félicitations ! 🎉
Partagez votre blog dans les commentaires, j’ai hâte de le voir !
Tutoriel par David Yéboué – Expert WordPress Headless à Abidjan, CI