Aller au contenu principal
Version: 26.0.10.0

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 :

app/Services/LoggerService.php
<?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 :

  1. La commande affiche une liste de constantes WordPress courantes avec leur description
  2. Vous sélectionnez la constante à configurer
  3. Selon le type de constante, vous êtes invité à choisir une valeur (booléen, choix multiple, ou valeur libre)
  4. La constante est ajoutée/modifiée dans wp-config.php via WP-CLI

Constantes disponibles :

ConstanteTypeDescriptionValeurs possibles
DISABLED_WP_CRONBooléenDésactiver le cron de WordPresstrue / false
WP_POST_REVISIONSChoixLimiter le nombre de révisionstrue (illimité), false (désactivé), nombre personnalisé
AUTOSAVE_INTERVALLibreFréquence de l'autosave (secondes)Nombre (ex: 300)
EMPTY_TRASH_DAYSLibreJours avant suppression définitiveNombre (ex: 14)
DISALLOW_FILE_EDITBooléenDésactiver l'édition de fichiers depuis l'admintrue / false
DISALLOW_FILE_MODSBooléenDésactiver l'installation de plugins/thèmes depuis l'admintrue / false
AUTOMATIC_UPDATER_DISABLEDBooléenDésactiver les mises à jour automatiquestrue / false
WP_AUTO_UPDATE_COREChoixNiveau de mise à jour automatiquetrue, false, minor
IMAGE_EDIT_OVERWRITEBooléenÉcraser les images modifiées sans copiertrue / 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
Attention

Cette commande modifie directement votre fichier wp-config.php. Assurez-vous d'avoir une sauvegarde avant de l'utiliser en production.


Voir aussi​