Aller au contenu principal
Version: 26.0.10.0

Architecture Elementum

Comprendre comment Elementum fonctionne et comment organiser votre code.

Positionnement d'Elementum​

Elementum est un plugin WordPress qui se charge automatiquement en premier grâce à un mu-plugin généré à l'activation.

Installation technique​

wp-content/
├── mu-plugins/
│ └── elementum-loader.php ← Créé automatiquement
├── plugins/
│ ├── elementum/ ← Plugin Elementum
│ │ ├── src/
│ │ ├── app/
│ │ └── elementum.php
│ └── mon-plugin-metier/ ← Votre plugin
└── themes/
└── mon-theme/ ← Votre thème

Chargement prioritaire​

À l'activation, Elementum :

  1. Crée wp-content/mu-plugins/elementum-loader.php
  2. Ce mu-plugin force Elementum à être premier dans la liste des plugins actifs
  3. Elementum est ainsi toujours disponible pour vos plugins et thèmes

Les 3 couches de développement​

1. Elementum (Framework)​

Le cœur technique — fourni par le plugin Elementum.

Contient :

  • Services (router, twig, config, etc.)
  • Helpers (Collection, Response, Yaml, etc.)
  • Attributs PHP (#[Route], #[Template], etc.)
  • Façades (Query, Post, Taxonomy, etc.)

Exemple d'utilisation :

use Elementum\Facades\Query;
use Elementum\Attributes\Route;

#[Route('/api/posts', methods: ['GET'])]
public function getPosts()
{
    return Query::all('post');
}

→ Services
→ Façades
→ Helpers


2. Plugins métiers​

Vos extensions spécifiques (dont votre "usine à site").

Contient :

  • Custom Post Types
  • Logique métier
  • API personnalisées
  • Services personnalisés

Structure type :

mon-plugin/
├── app/
│ ├── Controllers/
│ ├── PostTypes/
│ └── Services/
├── config/
│ └── post-types/
└── views/

Exemple :

app/PostTypes/Property.php
class Property extends PostType
{
    public function slug(): string
    {
        return 'property';
    }

    public function taxonomies()
    {
        $this->addTaxonomy('location', 'Localisation')
            ->register();
    }
}

→ Post Types
→ Créer un plugin


3. Thèmes​

La présentation de votre site.

Contient :

  • Templates Twig
  • Assets (SCSS, TypeScript, React)
  • Configuration Customizer

Structure type :

mon-theme/
├── views/
│ ├── base.html.twig
│ └── single/
├── assets/
│ ├── src/
│ └── dist/
└── config/
└── customize/

Exemple :

views/single/property.html.twig
{% extends 'base.html.twig' %}

{% block content %}
    <h1>{{ post.title }}</h1>
    {{ component('property-card', { post: post }) }}
{% endblock %}

→ Twig
→ Assets


Flux de données typique​

Requête HTTP
↓
Router Elementum (#[Route])
↓
Controller (plugin métier)
↓
Façade Query → Post Types
↓
Template Twig (thème)
↓
Réponse HTML

Exemple concret : Site immobilier​

Structure du projet​

wp-content/
├── mu-plugins/
│ └── elementum-loader.php
│
├── plugins/
│ ├── elementum/
│ └── real-estate/
│ ├── app/PostTypes/Property.php
│ └── app/Controllers/PropertyController.php
│
└── themes/
└── real-estate-theme/
├── views/property/
└── assets/src/

Dans le plugin métier​

app/Controllers/PropertyController.php
use Elementum\Attributes\Route;
use Elementum\Facades\Query;

class PropertyController
{
    #[Route('/properties/{id}', methods: ['GET'])]
    public function show(int $id): array
    {
        $property = Query::find($id, 'property');

        // Le namespace @theme, précise qu'il faut aller chercher le template dans le thème.
        // Autrement, le template est cherché dans le dossier `views` du plugin.
        return $this->render('@theme/property/show.html.twig', [
            'post' => $property
        ]);
    }
}
info
  • #[Route] crée l'URL personnalisée /properties/{id}
  • La méthode retourne explicitement un rendu Twig avec $this->render()

Dans le thème​

views/property/show.html.twig
{% extends 'base.html.twig' %}

{% block content %}
    <article class="property">
        <h1>{{ post.title }}</h1>
        <p class="price">{{ post.getField('price') }}€</p>
        <p class="surface">{{ post.getField('surface') }}m²</p>

        {{ component('property-gallery', {
            images: post.getField('gallery')
        }) }}
    </article>
{% endblock %}

Pourquoi cette architecture ?​

✅ Avantages​

AvantageExplication
Chargement garantiElementum est toujours chargé avant vos plugins
Séparation claireFramework / Métier / Présentation
RéutilisableVotre "usine à site" est un plugin comme un autre
ÉvolutifAjoutez/supprimez des plugins sans casser Elementum
TestableLogique métier isolée dans des services

🎯 Cas d'usage​

  • Usine à site = Un plugin qui utilise Elementum
  • Plugin e-commerce = Un autre plugin qui utilise Elementum
  • Plugin blog = Encore un autre plugin
  • Tous partagent : Les services, helpers et façades d'Elementum

Bonnes pratiques​

✅ À faire​

  • Séparer logique et présentation : Controllers ≠ Templates
  • Utiliser les façades : Plus simple que l'API WordPress native
  • Configuration YAML : Centralisez vos configurations
  • Services réutilisables : Logique métier dans des services

❌ À éviter​

  • Logique métier dans le thème : Le thème ne fait que l'affichage
  • HTML dans les controllers : Utilisez Twig
  • Dupliquer le code : Créez des services réutilisables
  • Ignorer la séparation 3 couches : Gardez une architecture propre

Prochaines étapes​

  1. Installer Elementum
  2. Créer votre premier plugin
  3. Découvrir les façades