Gutenberg : retirer des niveaux de titre dans le bloc titre • Formation FSE

Le bloc titre propose par défaut les 6 niveaux de titre, mais vous n’aurez très probablement pas besoin de tous. Heureusement, il existe un hook pour configurer les attributs de chaque bloc de Gutenberg !

Sommaire du cours

Retirer les niveaux de titres

Le hook register_block_type_args a été introduit dans WordPress 6.7 et permet de manipuler les attributs de tous les blocs de Gutenberg.

C’est donc l’opportunité idéale de modifier les niveaux de titres proposés par le bloc titre, mais pas seulement !

Retirer les niveaux de titres

Pour modifier les niveaux de titres proposés par Gutenberg, c’est très simple. Il suffit d’ajouter ce petit bout de code dans le fichier functions.php de votre thème :

PHP

functions.php

<?php
function capitaine_remove_heading_levels($args, $block_type)
{
    if ($block_type !== 'core/heading') {
        return $args;
    }
    	
	# Définir les niveaux de titres disponibles
    $args['attributes']['levelOptions']['default'] = [1, 2, 3, 4];

    return $args;
}
add_action('register_block_type_args', 'capitaine_remove_heading_levels', 10, 2);

On commence tout d’abord par vérifier que l’on est bien dans un bloc titre via le paramètre $block_type fourni par le hook.

Ensuite, c’est dans la variable $args, et notamment dans le sous-tableau attributes, que l’on va pouvoir faire nos modifications. Dans cet exemple, je retire les niveaux 5 et 6 qui sont très rarement utilisés.

Maintenant, l’éditeur de blocs, essayez d’insérer un bloc titre et changez le niveau :

Gutenberg affiche un bloc titre avec ses options. Les niveaux de titre 5 et 6 ne sont pas proposés. — Cette fois, le bloc ne propose plus les niveaux 5 et 6

Seuls les niveaux 1 à 4 sont présents. Les niveaux 5 et 6 ont disparu !

D’ailleurs vous pourriez pousser le réglage encore plus loin : vous pourriez n’autoriser le niveau 1 seulement aux administrateurs du site (qui en ont besoin pour créer les modèles des pages). Les éditeurs quand-à-eux seront limités aux niveaux 2, 3 et 4.

PHP

functions.php

<?php 

function capitaine_remove_heading_levels($args, $block_type)
{
    if ($block_type !== 'core/heading') {
        return $args;
    }

    # Seul l'administrateur a accès au h1
    if( current_user_can('administrator') ) {
        $args['attributes']['levelOptions']['default'] = [1, 2, 3, 4];
    } else {
        $args['attributes']['levelOptions']['default'] = [2, 3, 4];
    }

    return $args;
}
add_action('register_block_type_args', 'capitaine_remove_heading_levels', 10, 2);

Vous pouvez faire à peu près ce que vous voulez dans ce hook !

Si vous êtes curieux de connaître les options des blocs et leur éventuelles options par défaut, n’hésitez pas à faire un var_dump() :

PHP

functions.php

<?php 

function capitaine_remove_heading_levels($args, $block_type)
{
    if ($block_type !== 'core/paragraph') {
        return $args;
    }

    var_dump($args['attributes']); 
	die;

    return $args;
}
add_action('register_block_type_args', 'capitaine_remove_heading_levels', 10, 2);

Pour l’instant, je n’ai pas trouvé d’autres usages utiles à ce hook. Et vous ? Est-ce que vous l’utilisez pour modifier d’autres réglages ?