Commandes Dobby disponibles
Elementum fournit un ensemble de commandes CLI pour faciliter le développement. Toutes les commandes s'exécutent avec php dobby.
Commandes de génération
make:controller
Crée un nouveau contrôleur MVC.
php dobby make:controller HomeController php dobby make:controller HomeController themes/mon-theme php dobby make:controller HomeController plugins/mon-plugin
Paramètres :
name(Requis) : Nom du contrôleur (ex:HomeController)where(Optionnel) : Emplacement (thème ou plugin)
Fichier généré : app/Controllers/HomeController.php
make:service
Crée un nouveau service Elementum avec le pattern Singleton.
php dobby make:service Logger php dobby make:service Logger plugins/elementum-addon
Paramètres :
name(Requis) : Nom du service (ex:Logger)where(Optionnel) : Chemin vers le thème/plugin
Fichier généré : app/Services/LoggerService.php
Structure :
<?php namespace App\Services; use Elementum\Interfaces\ServiceInterface; use Elementum\Traits\Singleton; class LoggerService implements ServiceInterface { use Singleton; public const string NAME = 'logger'; public function doSomething() { // Votre logique métier ici } // #[Kernel('services')] // public function register(\Elementum\Container $container) // { // $container->addService( // LoggerService::NAME, // [LoggerService::class, 'getInstance'] // ); // } }
Enregistrement : Décommentez l'attribut #[Kernel('services')] dans un contrôleur pour enregistrer le service.
Utilisation :
use Elementum\Facades\Plugin; $logger = Plugin::getService('logger'); $logger->doSomething();
make:post-type
Crée un nouveau Custom Post Type.
php dobby make:post-type Product php dobby make:post-type Product plugins/ecommerce
Paramètres :
name(Requis) : Nom du post type (ex:Product)where(Optionnel) : Emplacement (thème ou plugin)
Fichier généré : app/PostTypes/Product.php
make:block
Crée un nouveau bloc Gutenberg.
php dobby make:block Hero php dobby make:block Hero themes/mon-theme
Paramètres :
name(Requis) : Nom du bloc (ex:Hero)where(Optionnel) : Emplacement (thème ou plugin)
Fichier généré : blocks/hero/ avec toute la structure du bloc
make:admin-page
Crée une nouvelle page d'administration.
php dobby make:admin-page Settings php dobby make:admin-page Settings plugins/mon-plugin
Paramètres :
name(Requis) : Nom de la page (ex:Settings)where(Optionnel) : Emplacement (thème ou plugin)
Fichier généré : app/Controllers/Admin/SettingsPage.php
make:command
Crée une nouvelle commande CLI personnalisée.
php dobby make:command SyncData
Paramètres :
name(Requis) : Nom de la commande (ex:SyncData)
Fichier généré : app/Commands/SyncData.php
make:twig-filter
Crée un nouveau filtre Twig personnalisé.
php dobby make:twig-filter PriceFormat
Paramètres :
name(Requis) : Nom du filtre (ex:PriceFormat)
Fichier généré : app/Twig/PriceFormatFilter.php
make:twig-function
Crée une nouvelle fonction Twig personnalisée.
php dobby make:twig-function GetUser
Paramètres :
name(Requis) : Nom de la fonction (ex:GetUser)
Fichier généré : app/Twig/GetUserFunction.php
make:twig-tag
Crée un nouveau tag Twig personnalisé.
php dobby make:twig-tag Pagination
Paramètres :
name(Requis) : Nom du tag (ex:Pagination)
Fichier généré : app/Twig/PaginationTag.php
make:customize-field
Crée un champ Customizer WordPress.
php dobby make:customize-field HeaderSettings
Paramètres :
name(Requis) : Nom du champ (ex:HeaderSettings)
Fichier généré : customize/HeaderSettings.php
Commandes de boilerplate
new:theme
Crée un nouveau thème Elementum complet.
php dobby new:theme mon-theme
Paramètres :
name(Requis) : Nom du thème
Fichiers générés : Structure complète d'un thème Elementum
new:plugin
Crée un nouveau plugin Elementum.
php dobby new:plugin mon-plugin
Paramètres :
name(Requis) : Nom du plugin
Fichiers générés : Structure complète d'un plugin Elementum
new:child
Crée un thème enfant Elementum.
php dobby new:child mon-child-theme
Paramètres :
name(Requis) : Nom du thème enfant
Fichiers générés : Structure complète d'un thème enfant
Commandes utilitaires
publish
Duplique une configuration YAML d'Elementum ou d'un projet utilisant Elementum pour le projet courant.
php dobby publish
Exemple:
Je souhaite mettre à jour la version de RemixIcon, disponible dans config/app.yaml dans Elementum. Je peut executer la commande et dupliquer cette config pour mon thème ou mon plugin et override la configuration.
wp:config
Ajoute ou modifie des constantes WordPress directement dans le fichier wp-config.php via une interface interactive.
php dobby wp:config
Fonctionnement :
- La commande affiche une liste de constantes WordPress courantes avec leur description
- Vous sélectionnez la constante à configurer
- Selon le type de constante, vous êtes invité à choisir une valeur (booléen, choix multiple, ou valeur libre)
- La constante est ajoutée/modifiée dans
wp-config.phpvia WP-CLI
Constantes disponibles :
| Constante | Type | Description | Valeurs possibles |
|---|---|---|---|
DISABLED_WP_CRON | Booléen | Désactiver le cron de WordPress | true / false |
WP_POST_REVISIONS | Choix | Limiter le nombre de révisions | true (illimité), false (désactivé), nombre personnalisé |
AUTOSAVE_INTERVAL | Libre | Fréquence de l'autosave (secondes) | Nombre (ex: 300) |
EMPTY_TRASH_DAYS | Libre | Jours avant suppression définitive | Nombre (ex: 14) |
DISALLOW_FILE_EDIT | Booléen | Désactiver l'édition de fichiers depuis l'admin | true / false |
DISALLOW_FILE_MODS | Booléen | Désactiver l'installation de plugins/thèmes depuis l'admin | true / false |
AUTOMATIC_UPDATER_DISABLED | Booléen | Désactiver les mises à jour automatiques | true / false |
WP_AUTO_UPDATE_CORE | Choix | Niveau de mise à jour automatique | true, false, minor |
IMAGE_EDIT_OVERWRITE | Booléen | Écraser les images modifiées sans copier | true / false |
Exemple d'utilisation :
$ php dobby wp:config Sélectionnez une configuration à définir : [DISABLED_WP_CRON] `description...` ~ valeur par défaut : false [WP_POST_REVISIONS] `description...` ~ valeur par défaut : true [AUTOSAVE_INTERVAL] `description...` ~ valeur par défaut : 60 ... > DISABLED_WP_CRON Quel valeur pour cette constante ? (true/false) : [true] true [false] false > true Le configuration a bien été ajoutée Commande terminée
Résultat dans wp-config.php :
define( 'DISABLED_WP_CRON', true );
Prérequis :
- WP-CLI doit être installé et accessible via la commande
wp - WordPress doit être installé dans le répertoire défini par
ABSPATH
Cette commande modifie directement votre fichier wp-config.php. Assurez-vous d'avoir une sauvegarde avant de l'utiliser en production.