Aller au contenu principal
Version: 26.0.10.0

Tour rapide d'Elementum

Découvrez les fonctionnalités principales d'Elementum en 2 minutes.


1. Intercepter un template WordPress (#[Template])​

Le plus utilisé

L'attribut #[Template] est utilisé dans 90% des cas pour intercepter les templates WordPress natifs.

app/Controllers/PageController.php
use Elementum\Attributes\Template;

class PageController
{
    #[Template('page')]
    public function pageTemplate(): array
    {
        return $this->render('page.html.twig', ['title' => post.title]);
    }
    
    #[Template('single')]
    public function singleTemplate(): array
    {
        return $this->render('single.html.twig', ['post' => post]);
    }
}

→ Attribut Template


2. Créer une route URL personnalisée (#[Route])​

app/Controllers/ContactController.php
use Elementum\Attributes\Route;

class ContactController
{
    #[Route('/contact', methods: ['GET', 'POST'])]
    public function contact(Request $request): array
    {
        if ($request->isMethod('POST')) {
            // Traitement du formulaire
            return $this->redirectToRoute('contact-success');
        }
        
        return $this->render('contact.html.twig');
    }
}

→ Attribut Route


2. Gérer un formulaire​

app/Controllers/ContactController.php
#[Route('/contact', methods: ['POST'])]
public function submit(Request $request)
{
    $name = $request->get('name');
    
    $this->flashSuccess('Message envoyé !');
    
    return $this->redirectToRoute('contact');
}

→ Gestion des formulaires


3. Requête personnalisée​

use Elementum\Facades\Query;

$posts = Query::orderBy('date', 'DESC')
    ->limit(5)
    ->include(['author', 'categories'])
    ->get('post');

foreach ($posts as $post) {
    echo $post->title;
    echo $post->getField('custom_field');
}

→ Façade Query


4. Custom Post Type​

php dobby make:post Property
app/PostTypes/Property.php
use Elementum\Abstract\PostType;

class Property extends PostType
{
    const string SLUG = "property";
    
    public function __construct()
    {
        $this->slug = self::SLUG;
        $this->menuName = 'Immobilier';
        $this->labels = [
            'plural' => 'propriétés',
            'singular' => 'propriété',
        ];
        $this->icon = 'dashicons-building';
    }
}

→ Post Types


5. API REST​

app/Controllers/PropertyApi.php
use Elementum\Attributes\Api;

class PropertyApi
{
    #[Api(
        namespace: 'myplugin/v1',
        endpoint: '/properties',
        methods: 'GET'
    )]
    public function list(array $params, \WP_REST_Request $request)
    {
        return Query::all('property')->toArray();
    }
    
    #[Api(
        namespace: 'myplugin/v1',
        endpoint: '/properties/{id}',
        methods: 'GET'
    )]
    public function get(array $params, \WP_REST_Request $request)
    {
        return Query::find($params['id'], 'property');
    }
}

→ API REST


6. Bloc Gutenberg​

php dobby make:block HeroBanner

Structure générée :

mon-plugin/
├── app/Blocks/HeroBanner.php
├── blocks/hero-banner/
│ ├── editor.jsx
│ └── _index.scss
├── views/blocks/hero-banner.html.twig
└── assets/scss/blocks/hero-banner.scss

Questions posées :

  • Nom du bloc (ex: "Bannière d'accueil")
  • Slug (optionnel, ex: hero_banner)
  • Préfixe (optionnel, ex: elementum)

→ Blocs Gutenberg


7. Configuration YAML​

config/site.yaml
site:
  name: "Mon Site"
  description: "Description du site"
  logo: "/assets/logo.png"
  
colors:
  primary: "#3498db"
  secondary: "#2ecc71"
use Elementum\Helpers\Yaml;

$config = Yaml::config('site.yaml');
echo $config['site']['name'];

→ Configuration YAML


8. Template Twig​

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

{% block content %}
    <article class="property">
        <h1>{{ post.title }}</h1>
        
        {{ component('property-card', { 
            post: post,
            showPrice: true 
        }) }}
        
        <div class="content">
            {{ post.content|raw }}
        </div>
    </article>
{% endblock %}

→ Templates Twig


9. Messages flash​

// Dans un controller
$this->flashSuccess('Opération réussie !');
$this->flashError('Une erreur est survenue');
$this->flashWarning('Attention : action requise');
$this->flashInfo('Information importante');
{# Dans un template #}
{% for key, messages in flashbag.all %}
    {% for message in messages %}
        <div class="alert alert-{{ key }}">
            {{ message }}
        </div>
    {% endfor %}
{% endfor %}

→ Messages flash


10. Panel Customizer YAML​

customize/theme_options.yaml
theme_options:
    title: "Options du thème"
    priority: 10
    sections:
        colors:
            title: "Couleurs"
            fields:
                primary_color:
                    label: "Couleur principale"
                    type: "color_contrast"
                    default: "#007bff"
                    
        typography:
            title: "Typographie"
            fields:
                font_family:
                    label: "Police"
                    type: "font"
                    default: "'Roboto', sans-serif"

→ Customizer


Et beaucoup plus...​

  • 🎨 Customizer — Panels, sections, champs en YAML
  • 📧 Emails Twig — Templates d'emails avec Twig
  • 🔐 Rôles — Gestion des permissions
  • 🧩 Plugins — Système d'extensions
  • 🔄 Hooks — Points d'extension personnalisés
  • 📦 Services — Architecture orientée services

Prochaines étapes​

Installer Elementum | Architecture | Tutoriels