Aller au contenu principal
Version: Next

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​

Notre recommandation #1

Si vous débutez avec WordPress, cette formation est incontournable. Grafikart explique clairement les concepts fondamentaux avec des exemples concrets.

🔗 Voir la formation

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​

Pour aller plus loin

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 !

🔗 Voir la formation

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

Lien avec Elementum

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 PostType et Taxonomy

📚 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​

RessourceDescriptionLien
WordPress CodexDocumentation officielle de WordPresscodex.wordpress.org
Developer HandbookGuide pour les développeursdeveloper.wordpress.org
WordPress.orgSite officielwordpress.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

→ Documentation Template


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;
}

→ Façade Query


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();

→ Champs personnalisés


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();
    }
}

→ Créer un CPT


🛠️ 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

→ Toutes les commandes Dobby


📖 Glossaire​

TermeDéfinition
CPTCustom Post Type - Type de contenu personnalisé
TaxonomySystème de classification (catégories, tags)
HookPoint d'ancrage pour exécuter du code (Action/Filter)
TemplateFichier PHP qui génère le HTML d'une page
MetaDonnée personnalisée attachée à un post
SlugIdentifiant URL d'un post/page (ex: /mon-article)
MU-PluginPlugin "Must Use" - chargé automatiquement

🎓 Parcours d'apprentissage recommandé​

Semaine 1 : Les bases​

  1. Installer WordPress en local (LocalWP, Docker, etc.)
  2. Comprendre la hiérarchie des templates
  3. Apprendre les Conditional Tags
  4. Manipuler WP_Query

Semaine 2 : Contenu personnalisé​

  1. Créer un Custom Post Type
  2. Ajouter des taxonomies
  3. Utiliser les champs personnalisés (Meta)
  4. Afficher le contenu dans les templates

Semaine 3 : Elementum​

  1. Installer Elementum
  2. Comprendre l'architecture 3 couches
  3. Utiliser les attributs #[Template] et #[Route]
  4. Découvrir les façades (Query, Post, Taxonomy)

Semaine 4 : Approfondir​

  1. Créer des composants Twig
  2. Utiliser les helpers (Collection, Response)
  3. Configurer via YAML
  4. Créer des blocs Gutenberg

🔗 Autres ressources utiles​


Besoin d'aide ?​