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 :

Ce que vous allez construire :

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 :

  1. Allez dans Settings → Permalinks
  2. Sélectionnez Post name
  3. 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

  1. Posts → Add New
  2. Créez 3 articles rapides
  3. Ajoutez des images à la une
  4. Assignez des catégories
  5. 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

  1. Allez sur vercel.com
  2. Connectez-vous avec GitHub
  3. New Project
  4. Sélectionnez votre repo
  5. 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 :

  1. 📧 Ajouter les commentaires (Disqus ou API WordPress)
  2. 🔍 Ajouter la recherche
  3. 🏷️ Filtrer par catégories
  4. 📱 Ajouter une newsletter
  5. 🎨 Personnaliser le design

Conclusion

En 30 minutes, vous avez :

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

Laisser un commentaire

Votre adresse e-mail ne sera pas publiée. Les champs obligatoires sont indiqués avec *