Lorsque vous créez un type de publication personnalisé (Custom Post Type, CPT) sur WordPress, l’éditeur Gutenberg n’est pas activé par défaut pour plusieurs raisons techniques et de conception.
WordPress traite les types d’articles personnalisés de manière légèrement différente des articles et pages standards. Les custom post types sont souvent utilisés pour des contenus spécifiques qui n’ont pas besoin des fonctionnalités avancées de mise en page fournies par Gutenberg.
Par exemple, un type d’article personnalisé pour gérer des témoignages, des listes de produits, ou des portfolios pourrait ne nécessiter qu’un ensemble limité de champs personnalisés, et non pas un éditeur avancé. Activer Gutenberg par défaut sur ces types de contenus pourrait compliquer inutilement l’interface utilisateur, en particulier si les types de contenus sont destinés à être simples et directifs.
Les développeurs de thèmes et de plugins doivent explicitement déclarer la prise en charge de Gutenberg pour leurs CPT. Cette étape nécessite un codage supplémentaire et des tests pour s’assurer que toutes les fonctionnalités de Gutenberg fonctionnent correctement avec le type d’article personnalisé. Cela inclut la gestion des blocs, la mise en page et les styles personnalisés.
Comment activer l’éditeur Gutenberg pour un type de post personnalisé ?
Gutenberg utilise l’API REST. Par défaut, le paramètre API REST est désactivé lorsque vous enregistrez un type de post personnalisé. Vous devez donc l’activer intentionnellement dans le code qui gère votre CPT.
Introduction à l’éditeur Gutenberg
L’éditeur Gutenberg est le nouvel éditeur de contenu par défaut dans WordPress depuis la version 5.0. Il apporte une expérience de création de contenu plus visuelle et flexible qu’avec l’ancien éditeur classique.
Avec Gutenberg, le contenu est créé à partir de blocs que l’on peut déplacer et organiser à sa guise : texte, images, listes, tableaux, boutons, etc. Il suffit de les assembler de manière modulaire pour construire ses pages et articles.
L’interface se rapproche d’un traitement de texte comme Word, avec une colonne latérale pour ajouter tous les blocs et voir l’arborescence. Le rendu visuel à gauche permet d’avoir un aperçu direct du résultat final.
Quelle est la différence entre l’éditeur Gutenberg et Classical editor
L’éditeur classique et l’éditeur Gutenberg proposent deux approches radicalement différentes pour créer du contenu dans WordPress.
Avec l’éditeur classique, on rédige directement le texte en clair et on utilise des balises HTML pour le mettre en forme. Le rendu visuel n’est pas directement visible, il faut passer par l’étape de prévisualisation pour voir le résultat final. Les possibilités de mise en page sont assez limitées.
A l’inverse, Gutenberg est un éditeur entièrement visuel basé sur des blocs de contenu à assembler (texte, images, boutons…). On glisse ces blocs dans l’ordre souhaité et on obtient en direct le rendu final. Tout se passe dans une interface intuitive avec divers outils pour donner vie à son contenu.
Alors que l’éditeur classique demande de connaitre le HTML, Gutenberg ne nécessite aucune compétence technique particulière. Mais en contrepartie, une petite période d’adaptation est requise pour prendre en main cette nouvelle approche modulaire de création de contenus dans WordPress.
De quoi avez-vous besoin pour activer Gutenberg pour un Custom Post Type ?
Il va de soit que pour activer Gutenberg pour les CPT, il faut au préalable que vous ayez activer un Custom Post Type.
Plusieurs solutions pour cela :
- Soit vous avez utiliser un plugin tel que Custom Post Type UI.
- Soit vous avez ajouter votre Custom Post Type avec du code.
Si ce n’est pas le cas, je vous laisse consulter notre guide dédié à la création de type de post personnalisés.
Activer Gutenberg pour un type d’article personnalisé crée avec Custom Post Type UI
Si vous avez créer votre custom post type avec Custom Post Type UI, dans ce cas il sera très facile d’activer Gutenberg pour votre type d’article.
- Rendez-vous dans : CPT UI ⇒ Ajouter/modifier des types de publication
- Ensuite, cliquez sur l’onglet : Modifier les types de publications
- Naviguez jusqu’à : “Afficher dans l’API REST”, et sélectionnez “Vrai”.
Activer Gutenberg pour un type d’article personnalisé crée avec du code
Si vous avez créer votre custom post type en l’injectant via votre fichier functions.php ou tout autre plugin, alors la procédure sera différente mais tout aussi simple.
Allez simplement dans le fichier functions.php ou vous avez déclarer votre CPT et ajoutez la ligne suivante dans les arguments ($args) :
'show_in_rest' => true, // To use Gutenberg editor.Ce qui devrait ressembler à quelque chose comme ceci :
Nous avons vu étape par étape dans ce tutoriel comment activer et configurer l’éditeur Gutenberg sur un type de contenu personnalisé dans WordPress.
L’activation des blocs, le changement d’éditeur par défaut, l’optimisation de l’affichage dans l’administration et l’ajout de blocs additionnels n’auront plus de secret pour vous. Mettre en place Gutenberg sur un custom post type est tout à fait réalisable moyennant quelques réglages.
Vous disposez désormais de toutes les clés pour tirer pleinement parti de ce puissant éditeur visuel sur vos contenus custom dans WordPress. N’hésitez pas à expérimenter différentes configurations pour trouver celles qui correspondent le mieux à vos besoins et à votre workflow de création de contenu.
