Aller au contenu principal
Version: Next

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.

→ Architecture détaillée


✅ 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.

→ Attributs PHP


✅ 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.

→ Documentation Twig


✅ 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.

→ Configuration YAML


Comparaison rapide​

TâcheWordPress purElementum
Créer une routeadd_rewrite_rule() + hooks#[Route('/path')]
Template personnaliséHiérarchie complexe (15+ fichiers)1 fichier Twig
Custom Post Type50+ lignes de codephp dobby make:post MyPost
API RESTregister_rest_route()#[Api(...)]
Formulaire adminadd_menu_page() + hooksphp dobby make:admin:page MyPage
Requête personnaliséeWP_Query + boucleQuery::all('post')

Prêt à commencer ?​

Installer Elementum | Voir les exemples | Tutoriels