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 :
- Crée
wp-content/mu-plugins/elementum-loader.php - Ce mu-plugin force Elementum à être premier dans la liste des plugins actifs
- 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 %}
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
| Avantage | Explication |
|---|---|
| Chargement garanti | Elementum est toujours chargé avant vos plugins |
| Séparation claire | Framework / Métier / Présentation |
| Réutilisable | Votre "usine à site" est un plugin comme un autre |
| Évolutif | Ajoutez/supprimez des plugins sans casser Elementum |
| Testable | Logique 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