Aller au contenu principal
Version: Next

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​

  1. Téléchargez le dépôt Elementum
  2. Extrayez-le dans wp-content/plugins/elementum/

Étape 2 : Activer Elementum​

Via l'admin WordPress​

  1. Connectez-vous à votre tableau de bord WordPress
  2. Allez dans Extensions > Extensions installées
  3. 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 :

  1. Désactivez Elementum
  2. Réactivez-le
  3. Vérifiez les permissions du dossier wp-content/

Prochaines étapes​

  1. Architecture Elementum
  2. Tour rapide
  3. Premier controller

Ressources​