04 — Utiliser les plugins et écrire une première extension

Installer un plugin existant

Grav permet l'installation par GPM, manuellement ou via l'administration. Commence par un plugin simple et lis sa documentation avant activation.

Les plugins vivent dans user/plugins/.

bin/gpm install NOM_DU_PLUGIN

Comprendre les événements

Les plugins Grav s'abonnent aux événements du cycle de vie. C'est le même principe général que les hooks WordPress ou les pipelines SPIP : intervenir sans modifier le cœur.

public static function getSubscribedEvents(): array
{
    return [
        'onPluginsInitialized' => ['onPluginsInitialized', 0],
    ];
}

Créer un plugin d'apprentissage

Crée un plugin minuscule qui ajoute une information non critique. Utilise les outils DevTools de Grav si disponibles pour générer un squelette compatible avec ta version.

user/plugins/mon-plugin/
├── mon-plugin.php
├── mon-plugin.yaml
└── blueprints.yaml

Comprendre comment PTM pourrait s'y brancher

Un futur PTM Grav devrait inventorier les plugins actifs, analyser les pages rendues, utiliser ptm-rules et afficher les résultats dans l'administration.

Le moteur de règles resterait commun ; seul l'adaptateur Grav serait spécifique.

ptm-rules
   ↓
PTM Grav adapter
   ↓
plugins + pages + HTML rendu