Débuter avec WordPress
Cette page regroupe les ressources essentielles pour les développeurs qui découvrent WordPress et souhaitent apprendre à utiliser Elementum efficacement.
🎓 Formations recommandées
1. WordPress — Découverte et prise en main par Grafikart
Si vous débutez avec WordPress, cette formation est incontournable. Grafikart explique clairement les concepts fondamentaux avec des exemples concrets.
Au programme :
- ✅ Installation et configuration de WordPress
- ✅ Compréhension de l'interface d'administration
- ✅ Création de contenu (articles, pages)
- ✅ Gestion des médias
- ✅ Thèmes et extensions
- ✅ Notions de développement WordPress
Durée : ~2 heures de vidéo
Niveau : Débutant
Prix : Gratuit
2. Créer un thème WordPress par Grafikart
Une fois les bases acquises, cette formation vous apprendra à créer un thème WordPress de A à Z. Parfait avant de se lancer dans Elementum !
Au programme :
- ✅ Structure d'un thème WordPress
- ✅ La hiérarchie des templates
- ✅ The Loop et les requêtes personnalisées
- ✅ Fonctions de template
- ✅ Custom Post Types et taxonomies
- ✅ Bonnes pratiques de développement
Durée : ~4 heures de vidéo
Niveau : Intermédiaire
Prix : Gratuit
Les concepts appris dans cette formation sont directement applicables avec Elementum :
- La hiérarchie des templates → Attribut
#[Template] - The Loop → Façade
Query - CPT/Taxonomies → Classes
PostTypeetTaxonomy
📚 Les bases de WordPress
Comprendre l'architecture WordPress
Avant de commencer avec Elementum, il est important de comprendre comment fonctionne WordPress :
- Le Cycle de vie d'une requête : Comment WordPress traite une URL
- La hiérarchie des templates : Quel fichier template est utilisé
- Le système de hooks : Actions et filtres
- La base de données : Structure et tables principales
🔗 Ressources officielles
Documentation WordPress
| Ressource | Description | Lien |
|---|---|---|
| WordPress Codex | Documentation officielle de WordPress | codex.wordpress.org |
| Developer Handbook | Guide pour les développeurs | developer.wordpress.org |
| WordPress.org | Site officiel | wordpress.org |
🎯 Références indispensables
1. Hiérarchie des templates WordPress
Comprendre quel template est chargé selon le type de page.
Ressource : Template Hierarchy
En résumé :
Page d'accueil
├── front-page.php (si page statique)
├── home.php (si page des articles)
└── index.php (fallback)
Article unique
├── single-{post-type}.php
├── single.php
└── index.php
Page
├── page-{slug}.php
├── page-{id}.php
├── page.php
└── index.php
Archive
├── archive-{post-type}.php
├── archive-{taxonomy}.php
├── archive.php
└── index.php
404
└── 404.php
Avec Elementum : Utilisez l'attribut #[Template] pour intercepter ces templates :
#[Template('single')] // Intercepte single.php #[Template('page')] // Intercepte page.php #[Template('archive')] // Intercepte archive.php #[Template('404')] // Intercepte 404.php
2. Liste des hooks WordPress (Actions & Filters)
Les hooks permettent d'interagir avec WordPress à des moments précis.
Ressource : Plugin API - Actions
Ressource : Plugin API - Filters
Hooks courants :
// Actions (exécuter du code) add_action('init', function() { // Au chargement de WordPress }); add_action('wp_head', function() { // Dans le <head> du site }); add_action('admin_init', function() { // Dans l'admin WordPress }); // Filters (modifier des données) add_filter('the_content', function($content) { return $content . '<p>Signature</p>'; }); add_filter('template_include', function($template) { // Modifier le template chargé return $template; });
Avec Elementum : Utilisez les attributs #[Hook], #[Action], #[Filter] :
#[Hook('init')] public function onInit() { // Exécuté au hook 'init' } #[Action('wp_head')] public function inHead() { // Exécuté dans <head> } #[Filter('the_content')] public function filterContent(string $content): string { return $content . '<p>Signature</p>'; }
→ Documentation des hooks Elementum
3. Fonctions WordPress essentielles
Requêtes (WP_Query)
// Récupérer des posts $query = new WP_Query([ 'post_type' => 'post', 'posts_per_page' => 10 ]); if ($query->have_posts()) { while ($query->have_posts()) { $query->the_post(); the_title(); the_content(); } wp_reset_postdata(); }
Avec Elementum : Utilisez la façade Query :
use Elementum\Facades\Query; $posts = Query::limit(10)->get('post'); foreach ($posts as $post) { echo $post->title; echo $post->content; }
Métadonnées (Post Meta)
// Récupérer une meta $value = get_post_meta($post_id, 'ma_cle', true); // Mettre à jour une meta update_post_meta($post_id, 'ma_cle', 'valeur'); // Supprimer une meta delete_post_meta($post_id, 'ma_cle');
Avec Elementum : Utilisez les champs personnalisés :
// Récupérer un champ $price = $post->getField('price'); // Récupérer tous les champs $fields = $post->getFields();
Taxonomies et termes
// Récupérer les termes d'un post $terms = get_the_terms($post_id, 'category'); // Récupérer un terme $term = get_term_by('slug', 'mon-term', 'category'); // Créer un terme wp_insert_term('Nouveau terme', 'category');
Avec Elementum : Utilisez la façade Taxonomy :
use Elementum\Facades\Post; $post = new Post($postId); $category = $post->taxonomy('category');
→ Façade Post
→ Façade Taxonomy
4. Conditional Tags (Balises conditionnelles)
Savoir sur quel type de page on se trouve.
Ressource : Conditional Tags
Principales conditions :
is_home() // Page des articles is_front_page() // Page d'accueil is_single() // Article unique is_page() // Page unique is_archive() // Page d'archive is_search() // Résultats de recherche is_404() // Page 404 is_admin() // Dans l'administration is_singular('post') // Type de post spécifique is_post_type_archive('product') // Archive d'un CPT
Avec Elementum : Ces conditions sont gérées par l'attribut #[Template] :
#[Template('home')] // is_home() ou is_front_page() #[Template('single')] // is_single() #[Template('page')] // is_page() #[Template('archive')] // is_archive() #[Template('search')] // is_search() #[Template('404')] // is_404()
5. Custom Post Types & Taxonomies
Ressource : Custom Post Types
Ressource : Custom Taxonomies
En WordPress pur :
add_action('init', function() { register_post_type('product', [ 'public' => true, 'label' => 'Produits', 'supports' => ['title', 'editor', 'thumbnail'] ]); register_taxonomy('brand', 'product', [ 'public' => true, 'label' => 'Marques' ]); });
Avec Elementum :
php dobby make:post Product
use Elementum\Abstract\PostType; class Product extends PostType { const string SLUG = "product"; public function __construct() { $this->slug = self::SLUG; $this->menuName = 'Produits'; $this->labels = [ 'plural' => 'Produits', 'singular' => 'Produit' ]; $this->icon = 'dashicons-cart'; } public function taxonomies() { $this->addTaxonomy('brand', 'Marques')->register(); } }
🛠️ Outils de développement
1. Admin Bar
Affiche des informations de débogage dans la barre d'administration.
Plugin recommandé : Query Monitor
- Requêtes SQL
- Hooks exécutés
- Templates chargés
- Erreurs PHP
2. Débogage WordPress
Activez le mode débogage dans wp-config.php :
define('WP_DEBUG', true); define('WP_DEBUG_LOG', true); define('WP_DEBUG_DISPLAY', false); define('SCRIPT_DEBUG', true);
Les erreurs sont journalisées dans wp-content/debug.log.
3. Générateurs de code
Avec Elementum :
# Créer un controller php dobby make:controller HomeController # Créer un CPT php dobby make:post Product # Créer un bloc Gutenberg php dobby make:block Hero # Créer un service php dobby make:service Logger
📖 Glossaire
| Terme | Définition |
|---|---|
| CPT | Custom Post Type - Type de contenu personnalisé |
| Taxonomy | Système de classification (catégories, tags) |
| Hook | Point d'ancrage pour exécuter du code (Action/Filter) |
| Template | Fichier PHP qui génère le HTML d'une page |
| Meta | Donnée personnalisée attachée à un post |
| Slug | Identifiant URL d'un post/page (ex: /mon-article) |
| MU-Plugin | Plugin "Must Use" - chargé automatiquement |
🎓 Parcours d'apprentissage recommandé
Semaine 1 : Les bases
- Installer WordPress en local (LocalWP, Docker, etc.)
- Comprendre la hiérarchie des templates
- Apprendre les Conditional Tags
- Manipuler WP_Query
Semaine 2 : Contenu personnalisé
- Créer un Custom Post Type
- Ajouter des taxonomies
- Utiliser les champs personnalisés (Meta)
- Afficher le contenu dans les templates
Semaine 3 : Elementum
- Installer Elementum
- Comprendre l'architecture 3 couches
- Utiliser les attributs
#[Template]et#[Route] - Découvrir les façades (Query, Post, Taxonomy)
Semaine 4 : Approfondir
- Créer des composants Twig
- Utiliser les helpers (Collection, Response)
- Configurer via YAML
- Créer des blocs Gutenberg
🔗 Autres ressources utiles
- WordPress Stack Exchange : wordpress.stackexchange.com
- Make WordPress : make.wordpress.org
- WPBeginner : wpbeginner.com
- Advanced Custom Fields : advancedcustomfields.com