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]); } }
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'); } }
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'); }
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'); }
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'; } }
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)
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'];
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 %}
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 %}
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"
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