Installation d'Elementum
Installer et configurer Elementum en 5 minutes.
Prérequis
- PHP 8.0 ou supérieur
- WordPress 6.0 ou supérieur
- Composer (pour les dépendances PHP)
- Node.js 18+ (pour les assets)
- Git (optionnel, recommandé)
Étape 1 : Installer Elementum
Option A : Via Git (recommandé)
cd wp-content/plugins/ git clone https://gitlab.com/devopress/framework/elementum.git
Option B : Manuellement
- Téléchargez le dépôt Elementum
- Extrayez-le dans
wp-content/plugins/elementum/
Étape 2 : Activer Elementum
Via l'admin WordPress
- Connectez-vous à votre tableau de bord WordPress
- Allez dans Extensions > Extensions installées
- Trouvez Elementum et cliquez sur Activer
Via WP-CLI
wp plugin activate elementum
Authentification
Lorsque Elementum est activé, il modifie le chemin de connexion au site.
L'URL de connexion devient https://monsite.fr/elementum/admin. Ce dernier peut-être personnalisé via la configuration auth.yaml.
info
À l'activation, Elementum crée automatiquement un fichier mu-plugins/elementum-loader.php qui le charge en premier.
Étape 3 : Vérifier l'installation
Vérifier le mu-plugin
ls wp-content/mu-plugins/ # Doit afficher : elementum-loader.php
Lister les commandes Dobby
cd wp-content/plugins/elementum/ php dobby list
Sortie attendue :
Available commands:
make:controller Créer un controller
make:service Créer un service
make:post-type Créer un Post Type
make:block Créer un bloc Gutenberg
new:plugin Créer un plugin
new:theme Créer un thème
new:child Créer un thème enfant
publish Publier la configuration
Étape 4 : Créer votre premier projet
Créer un plugin
php dobby new:plugin mon-plugin
Structure générée :
mon-plugin/
├── app/
│ ├── Controllers/
│ └── Services/
├── config/
├── views/
├── composer.json
├── package.json
└── vite.config.js
Créer un thème
php dobby new:theme mon-theme
Structure générée :
mon-theme/
├── views/
├── assets/
│ ├── src/
│ └── dist/
├── config/
├── composer.json
├── package.json
└── vite.config.js
Étape 5 : Installer les dépendances
Pour votre plugin/thème
cd mon-plugin/ composer install npm install
Build des assets
npm run build # Ou en mode développement : npm run dev
Activation du projet
Activer un plugin
wp plugin activate mon-plugin
Activer un thème
wp theme enable mon-theme
Vérification finale
Tester une route
Créez un controller simple :
mon-plugin/app/Controllers/HelloController.php
use Elementum\Attributes\Route; class HelloController { #[Route('/hello', methods: ['GET'])] public function index(): array { return $this->render('hello.html.twig', [ 'message' => 'Bienvenue sur Elementum !' ]); } }
info
La méthode doit appeler $this->render() explicitement pour afficher un template Twig.
Créez le template :
mon-plugin/views/hello.html.twig
<h1>{{ message }}</h1>
Visitez http://votre-site.com/hello — vous devriez voir votre message.
Problèmes courants
❌ "Command 'dobby' not found"
Solution :
cd wp-content/plugins/elementum/ php dobby
astuce
Dobby est présent à la racine de chaque projet Elementum.
❌ "Class not found"
Solution :
composer dump-autoload
❌ "Mu-plugin not created"
Solution :
- Désactivez Elementum
- Réactivez-le
- Vérifiez les permissions du dossier
wp-content/