🔵 WordPress — La documentation complète (Débutant → Expert)

Documentation exhaustive en français pour maîtriser WordPress, écrite pour un développeur web Next.js / React qui part de zéro sur WordPress et veut devenir expert — avec un axe assumé : gagner sa vie (freelance, plugins, thèmes, headless).

Version couverte : WordPress 6.x (PHP 8.1+, éditeur de blocs & Full Site Editing, theme.json, REST API). WooCommerce est traité en Partie 10.

Pourquoi ce cours, pour vous précisément

WordPress fait tourner ~43 % du web. C’est un océan de missions, de plugins et de produits. Mais la plupart des tutoriels s’adressent à des débutants totaux ou à des « intégrateurs ». Vous, vous arrivez avec un atout rare :

• Gutenberg est du React. L’éditeur moderne de WordPress est une application React (@wordpress/element, @wordpress/data, JSX). Vous savez déjà penser en composants, état, props — vous partez avec des années d’avance sur le dev WP classique.
• Le headless est votre terrain. WordPress comme back-office de contenu + Next.js en front (REST API ou WPGraphQL, SSG/ISR) : c’est exactement le pont que peu de gens savent construire proprement.
• Le marché paie ça cher. Un dev qui maîtrise WP et React/Next est exactement ce que cherchent les agences, les éditeurs de plugins et les clients headless.

Ce cours vous emmène du cœur PHP (hooks, boucle, WP_Query, base de données) jusqu’aux blocs React, au headless Next.js, à WooCommerce, puis à la monétisation.

Comment utiliser cette documentation

• Vous ne connaissez pas WordPress → Parties 1 à 3 (aucun code, purement fonctionnel).
• Vous voulez coder tout de suite → Partie 4 (environnement) puis Partie 5 (architecture) puis Partie 7 (plugins).
• Vous voulez faire du React dans WordPress → Partie 8 (blocs Gutenberg custom).
• Vous voulez brancher WordPress sur Next.js → Partie 9 (REST & headless).
• Vous voulez en vivre → Partie 13 (freelance, plugins premium, produits récurrents).

Chaque chapitre suit le même format (détail dans les conventions) : ⏱️ TL;DR, 🎯 objectifs, corps détaillé avec diagrammes Mermaid et code complet, ✏️ exercices corrigés et 🧠 quiz de fin.

Table des matières

1. Découvrir WordPress — ce qu’est WP, .org vs .com, l’écosystème (GPL, économie des plugins), le back-office, Gutenberg côté créateur.
2. Utiliser & administrer — réglages, permaliens, utilisateurs/rôles/capabilities, contenus, taxonomies, menus, maintenance.
3. Gutenberg & éditeur de site — blocs en profondeur, patterns, Full Site Editing, theme.json, templates.
4. Installation & environnement de dev — LocalWP / wp-env / Docker, wp-config, WP-CLI, structure du code, débogage.
5. Architecture du cœur — cycle de requête, hooks (actions & filtres), la Boucle, template hierarchy, WP_Query, base de données ($wpdb), options/transients, cron.
6. Développer des thèmes — thème classique, thème enfant, enqueue, thème bloc (FSE) et theme.json, distribution.
7. Développer des plugins — anatomie, hooks, Custom Post Types, métadonnées, Settings API, sécurité (nonces, sanitize/escape, capabilities), i18n, tutoriel complet.
8. Gutenberg : blocs custom en React — @wordpress/scripts, block.json, edit/save, contrôles, blocs dynamiques, InnerBlocks, stores @wordpress/data.
9. REST API & headless (Next.js) — REST interne, auth, endpoints custom, WPGraphQL, front Next.js (SSG/ISR, previews), arbitrages.
10. WooCommerce — architecture, hooks, personnalisation produits/checkout, extensions, paiements, Store API headless.
11. Niveau expert — sécurité/hardening, performance & caching (Redis, object cache), tests (PHPUnit, Jest, Playwright), standards & CI, multisite, publication sur wp.org.
12. Annexes — glossaire, cheatsheets, pièges & FAQ, ressources, parcours de carrière.
13. Monétiser — positionnement (React + WP = rare), freelance (Codeable, agences, Malt), produits récurrents (freemium, marketplaces, SaaS headless), cadre pratique FR.

Parcours recommandé (dev Next.js → expert WordPress)

Documentation basée sur WordPress 6.x. Sources principales : developer.wordpress.org , Block Editor Handbook , code source github.com/WordPress/wordpress-develop .