Pourquoi Elementum ?
Elementum apporte une approche moderne au développement WordPress en résolvant les problèmes récurrents des développeurs.
Les problèmes de WordPress traditionnel
❌ Code dispersé
functions.php (500+ lignes)
├── Custom Post Types
├── Shortcodes
├── Hooks en tout genre
└── Logique métier mélangée
Résultat : Difficile à maintenir, tester et faire évoluer.
❌ Pas de séparation logique/présentation
// Dans home.php <?php $query = new WP_Query([...]); ?> <header> <h1><?= get_bloginfo('name') ?></h1> </header> <?php while(have_posts($query)){ the_post(); ?> <article> <h2><?= get_the_title() ?></h2> </article> <?php } ?>>
Résultat : Templates difficiles à modifier, pas de réutilisation.
❌ Incohérence entre développeurs
Chaque développeur a sa propre façon de :
- Déclarer un Custom Post Type
- Créer une route personnalisée
- Gérer les formulaires admin
Résultat : Codebase incohérente, courbe d'apprentissage lente.
La solution Elementum
✅ Architecture MVC claire
mon-projet/
├── app/
│ ├── Controllers/ # Logique métier
│ ├── PostTypes/ # Custom Post Types
│ └── Services/ # Services réutilisables
├── views/
│ └── *.html.twig # Templates séparés
└── config/
└── *.yaml # Configuration centralisée
Avantage : Chaque chose à sa place, facile à maintenir.
✅ Syntaxe déclarative avec attributs PHP
// Une route = 1 attribut #[Route('/contact', methods: ['GET', 'POST'])] public function contact(Request $request) { if ($request->isMethod('POST')) { // Traitement du formulaire return $this->redirectToRoute('contact-success'); } return $this->render('contact.html.twig', [ 'form' => $this->getForm() ]); }
Avantage : Code lisible, intention claire, moins de boilerplate.
✅ Templates Twig puissants
{% extends 'base.html.twig' %} {% block content %} {{ component('card', { title: post.title, image: post.thumbnail }) }} {# Prend une WPQuery pour boucler et injecter une façade simplifié pour chaque WP_Post #} {% wp_query postQuery %} <h2>{{ post.title }}</h2> <a href="{{ post.link }}">Lire la suite</a> {% endwp_query %} {% endblock %}
Avantage : Templates propres, réutilisables, testables.
✅ Façades pour WordPress
// Au lieu de WP_Query... use Elementum\Facades\Query; $posts = Query::orderBy('date', 'DESC') ->limit(5) ->include(['price', 'surface']) ->get('property'); // Chaque post est un objet Post avec des méthodes foreach ($posts as $post) { echo $post->title; echo $post->getField('price'); }
Avantage : API fluide, orientée objet, intuitive.
→ Façades
✅ Configuration YAML
config/auth.yaml
login: urls: - /elementum/admin - /admin/elementum template: login: "@elementum/login/login.html.twig" error: "@elementum/login/404.html.twig" errors_message: invalid_username: "Nom d'utilisateur invalide" incorrect_password: "Mot de passe invalide" info: logo: "/assets/logo.webp" title: "Administration" email: "contact@exemple.fr" # config/theme_support.yaml post-thumbnails: true title-tag: true html5: - video - audio - fieldset
Avantage : Configuration lisible, versionnable, modifiable sans PHP.
Comparaison rapide
| Tâche | WordPress pur | Elementum |
|---|---|---|
| Créer une route | add_rewrite_rule() + hooks | #[Route('/path')] |
| Template personnalisé | Hiérarchie complexe (15+ fichiers) | 1 fichier Twig |
| Custom Post Type | 50+ lignes de code | php dobby make:post MyPost |
| API REST | register_rest_route() | #[Api(...)] |
| Formulaire admin | add_menu_page() + hooks | php dobby make:admin:page MyPage |
| Requête personnalisée | WP_Query + boucle | Query::all('post') |