Actions & Filtres
Elementum propose différents hooks (actions et filtres) pour personnaliser son fonctionnement. Voici la liste complète organisée par catégories.
Sommaire
Actions
astuce
Pour utiliser ces actions dans un contrôleur, utilisez l'attribut Kernel avec le nom du hook sans le préfixe elementum.kernel..
| Hook | Description | Paramètres |
|---|---|---|
elementum.kernel.services | Exécuté lors de l'initialisation des services | Elementum\Container $container |
elementum.kernel.init | Exécuté lors de l'initialisation de WordPress | Elementum\Container $container |
elementum.kernel.end | Exécuté à la fin de l'initialisation | Elementum\Kernel $kernel |
elementum.twig.globals | Permet d'ajouter des variables globales à Twig (déclenché sur init) | \Twig\Environment $twig |
Customize
Ces hooks sont déclenchés pendant l'action WordPress init pour chaque élément déclaré dans les fichiers YAML du Customizer. Ils sont disponibles dans tous les contextes (pas seulement dans customize_register).
| Hook | Description | Paramètres |
|---|---|---|
elementum.customize.adding.panel | Déclenché pour chaque panel déclaré dans les YAML | string $panelId, array $panelConfig |
elementum.customize.adding.section | Déclenché pour chaque section déclarée dans les YAML | string $sectionId, array $sectionConfig |
elementum.customize.adding.field | Déclenché pour chaque champ déclaré dans les YAML | string $fieldId, array $fieldConfig, string $sectionId |
Filtres
Filtres généraux
| Hook | Description | Paramètres | Valeur par défaut |
|---|---|---|---|
elementum.localize | Données passées à JavaScript via window.ELEMENTUM (front uniquement) | array $localize | - |
elementum.twig.extension.tags | Ajoute des tags Twig personnalisés | array $nativeTags | - |
elementum.natives.posts | Modifie les post-types natifs WordPress | array $natives | ['post', 'page', 'attachment'] |
Changelogs
| Hook | Description | Valeur par défaut |
|---|---|---|
elementum.changelog.theme.template | Template pour le changelog du thème | @elementum/changelog/theme.html.twig |
elementum.changelog.plugin.template | Template pour le changelog des plugins | @elementum/changelog/plugin.html.twig |
Sitemap
Templates
| Hook | Description | Valeur par défaut |
|---|---|---|
elementum.sitemap.shortcode.template | Template pour le shortcode elementum_sitemap | - |
Paramètres
| Hook | Description | Valeur par défaut |
|---|---|---|
elementum.sitemaps.remove_users | Supprime les pages auteurs (sécurité) | true |
elementum.sitemaps.remove_attachments | Supprime les pages d'attachement | true |
elementum.sitemaps.post_types | Types de contenu à inclure | [] |
elementum.sitemaps.taxonomies | Taxonomies à inclure | [] |
elementum.sitemaps.max_urls | Nombre maximum d'URLs | 2000 |
elementum.sitemaps.posts_query_args | Arguments de requête pour les articles | ['has_password' => false] |
elementum.sitemaps.ping.endpoints | Endpoints pour le ping des sitemaps | ['https://www.google.com/ping?sitemap={url}', 'https://www.bing.com/ping?sitemap={url}'] |