Comment créer un template pour un CPT avec Gutenberg

Gutenberg offre une interface intuitive de création de contenu par glisser-déposer, permettant une personnalisation en temps réel. En définissant des templates de blocs pour ton CPT, tu guides les utilisateurs dans la structuration de leur contenu, ce qui réduit les erreurs et assure une mise en forme cohérente.

Définir le template dans un custom post type

Tu peux également définir un modèle de blocs prédéfini que l’utilisateur verra lorsqu’il créera un nouveau contenu pour ce CPT. Cela se fait avec l’argument template lorsque tu enregistres le CPT.

Voici un exemple où tu définis un modèle de blocs pour le CPT portfolio :

PHP

function create_portfolio_cpt() {
    $labels = array(
        'name' => 'Portfolios',
        'singular_name' => 'Portfolio',
    );

    $args = array(
        'label' => 'Portfolios',
        'public' => true,
        'show_in_rest' => true,
        'supports' => array('title', 'editor', 'thumbnail', 'revisions', 'custom-fields'),
        'has_archive' => true,
        'rewrite' => array('slug' => 'portfolio'),
        'template' => array(  // Définition des templates de blocs
            array('core/heading', array(
                'level' => 2,
                'placeholder' => 'Add a heading',
            )),
            array('core/paragraph', array(
                'placeholder' => 'Add a description',
            )),
            array('core/image', array(
                'align' => 'center',
            )),
        ),
        'template_lock' => 'all',  // Empêche de supprimer les blocs de base
    );

    register_post_type('portfolio', $args);
}
add_action('init', 'create_portfolio_cpt');

Explications des options :

template : Un tableau contenant les blocs par défaut qui seront insérés lorsque l’utilisateur créera un nouveau contenu pour ce CPT.
template_lock : Peut être défini sur 'all' ou 'insert' :
- 'all' : L’utilisateur ne peut ni modifier ni supprimer les blocs définis.
- 'insert' : L’utilisateur peut modifier le contenu des blocs, mais pas les supprimer ni en ajouter de nouveaux.

Créer un template sur un CPT existant

Tu peux utiliser des filtres WordPress pour ajouter des templates de blocs à un CPT existant. Pour cela, tu peux utiliser le filtre register_post_type_args pour ajouter un modèle de bloc lorsque le CPT est enregistré.

Exemple de code à ajouter dans ton fichier functions.php :

PHP

function add_custom_template_to_cpt($args, $post_type) {
    // Remplace 'portfolio' par le slug de ton CPT
    if ($post_type === 'portfolio') {
        $args['template'] = array(
            array('core/heading', array('level' => 2, 'placeholder' => 'Titre')),
            array('core/paragraph', array('placeholder' => 'Description')),
            array('core/image', array('align' => 'center')),
        );
        $args['template_lock'] = 'all'; // Empêche les utilisateurs de modifier ou de supprimer les blocs par défaut
    }
    return $args;
}
add_filter('register_post_type_args', 'add_custom_template_to_cpt', 10, 2);

Créer un template de mise en page avec Gutenberg

Définir le template dans un custom post type

Créer un template sur un CPT existant