allowed_block_types<\/code>. Ce filtre vous donne deux param\u00e8tres ; un tableau de tous les blocs et l’objet post. Tout ce que nous avons \u00e0 faire est de g\u00e9rer le tableau avant de le retourner. Et parce que nous obtenons \u00e9galement l’objet de publication dans le filtre, nous pouvons \u00e9galement ajouter des r\u00e8gles par type de publication ou d’autres m\u00e9ta-informations de publication.<\/p>\nLe tableau de blocs se compose de cha\u00eenes de noms d’espace de noms du bloc. Tous les blocs de WordPress n\u00e9cessitent un espace de noms pr\u00e9fix\u00e9 avant le nom du bloc. Pour les blocs principaux de WordPress, l’espace de noms est " core\/<\/code>" et pour les blocs d’int\u00e9gration WordPress, l’espace de noms est " core-embed\/<\/code>". Par exemple, le bloc d’en-t\u00eate porte le nom " core\/heading<\/code>" dans ce tableau. J’ai cr\u00e9\u00e9 un aper\u00e7u complet de tous les noms de types de blocs dans mon article sur Comment pour acc\u00e9der et analyser les blocs d’un article<\/a>.<\/p>\nVoici un exemple rapide d’utilisation du filtre pour supprimer tous les blocs sauf le paragraphe. Cela s’appliquera \u00e0 tous les types de messages.<\/p>\n
add_filter('allowed_block_types', function($block_types, $post) {\n return ['core\/paragraph'];\n}, 10, 2);<\/code><\/pre>\nSi vous ajoutez ce code dans le fichier de votre th\u00e8me functions.php<\/code>ou de votre plugin, le r\u00e9sultat est que Gutenberg interdit compl\u00e8tement tout autre bloc que le paragraphe. Vous ne pourrez m\u00eame pas voir d’autres blocs, vous ne pouvez pas non plus essayer de les attirer en tapant \u00ab\/<\/code>\u00bb dans le message (raccourci de bloc) ou en les recherchant.<\/p>\n<\/p>\nNous pouvons d\u00e9finir les blocs que nous voulons conserver ou supprimer par type de publication. Nous v\u00e9rifions simplement la propri\u00e9t\u00e9 post_type<\/code>sur l’objet post. Dans l’exemple de code ci-dessous, nous d\u00e9finissons un nouveau tableau des blocs que nous voulons autoriser et ajoutons cette r\u00e8gle uniquement pour le type de publication personnalis\u00e9 ‘ book<\/code>‘.<\/p>\nadd_filter('allowed_block_types', function($block_types, $post) {\n $allowed = [\n 'core\/paragraph',\n 'core\/heading',\n 'core\/image'\n ];\n if ($post->post_type == 'book') {\n return $allowed;\n }\n return $block_types;\n}, 10, 2);<\/code><\/pre>\nAvec le code ci-dessus, vous obtenez tous les blocs lors de la modification des publications et des pages, mais lors de la modification du type de publication personnalis\u00e9 " book<\/code>", vous ne pouvez ajouter que des paragraphes, des titres et des images uniques.<\/p>\nUtilisez votre imagination pour ajouter vos propres r\u00e8gles. Parce que nous avons l’objet post, nous pouvons acc\u00e9der \u00e0 la plupart des informations dont nous aurions besoin. Peut-\u00eatre avez-vous besoin de limiter les choix de blocs par une post meta value? Par exemple, par le mod\u00e8le de page choisi, la cat\u00e9gorie de publication choisie ou autre chose.<\/p>\n
Liste blanche<\/h3>\n
Autant que je sache, vous ne pouvez mettre en liste blanche (d\u00e9cider lesquels supprimer, par opposition \u00e0 d\u00e9cider lequel conserver) les blocs qu’en d\u00e9senregistrant les blocs \u00e0 un certain point. Et vous devez le faire avec Javascript et non PHP.<\/p>\n
Je n’entrerai pas dans les d\u00e9tails \u00e0 ce sujet, mais vous devrez mettre en file d’attente un fichier Javascript charg\u00e9 dans init<\/code>ou enqueue_block_editor_assets<\/code>hook, avec wp-dom-ready<\/code>et wp-blocks<\/code>comme d\u00e9pendance. Dans le script, vous pouvez configurer une variable de celle(s) que vous souhaitez supprimer, en suivant les m\u00eames r\u00e8gles pour les espaces de noms et les noms de blocs ci-dessus. Et pour chaque nom de bloc, vous appelez la fonction unregisterBlockType()<\/code>du wp.blocks<\/code>package. Habituellement, vous devez le faire \u00e0 l’int\u00e9rieur d’une fonction wp.domReady()<\/code>pour vous assurer que l’ordre de chargement du script est correct.<\/p>\nQuelque chose comme \u00e7a:<\/p>\n
var removeBlocks = [\n 'core\/paragraph',\n 'core\/heading',\n 'core\/image'\n];\n\u00a0\nwp.domReady(function() {\n removeBlocks.forEach(function(blockName) {\n wp.blocks.unregisterBlockType(blockName);\n });\n});<\/code><\/pre>\nLa suppression des types de blocs est un moyen de contr\u00f4ler les blocs dans Gutenberg. Regardons l’autre fa\u00e7on, peut-\u00eatre plus amusante, de contr\u00f4ler les blocs: les mod\u00e8les de blocs.<\/p>\n
Mod\u00e8les de bloc<\/h2>\n
Une autre fa\u00e7on de contr\u00f4ler les blocs Gutenberg dans WordPress consiste \u00e0 utiliser des mod\u00e8les de blocs. WordPress a une fonctionnalit\u00e9 qui vous permet de remplir de nouveaux messages avec un ensemble de blocs pr\u00e9d\u00e9finis. Cela peut \u00eatre utile pour aider les auteurs en leur montrant une suggestion de structure de bloc. Vous pouvez \u00e9galement choisir de verrouiller ces blocs pr\u00e9remplis, emp\u00eachant ainsi les auteurs de r\u00e9organiser ou d’ajouter d’autres blocs. Ceci est utile lorsque vous souhaitez que les publications aient une structure et une conception sp\u00e9cifiques – par exemple, assurez-vous que toutes les publications de ce type de publication ont leurs informations structur\u00e9es exactement de la m\u00eame mani\u00e8re.<\/p>\n
Nous pouvons ajouter des mod\u00e8les de bloc avec un nouveau param\u00e8tre \u00e0 la [register_post_type](https:\/\/developer.wordpress.org\/reference\/functions\/register_post_type\/)()<\/code>fonction utilis\u00e9e pour enregistrer les types de publication personnalis\u00e9s (remarque\u00a0: le nouveau param\u00e8tre n’a pas encore \u00e9t\u00e9 ajout\u00e9 \u00e0 la documentation). Vous pouvez \u00e9galement ajouter ou ajuster les param\u00e8tres sur les types de publication existants tels que les publications et les pages – voir ci-dessous comment.<\/p>\nLe nouveau param\u00e8tre \u00e0 register_post_type()<\/code>est ‘ template<\/code>‘. Comme valeur pour ‘ template<\/code>‘, vous devez fournir un tableau de blocs. Chaque bloc doit \u00e9galement \u00eatre un tableau. Au minimum, vous devez fournir le premier \u00e9l\u00e9ment du tableau\u00a0; le nom du bloc (par exemple core\/paragraph<\/code>). Vous pouvez \u00e9ventuellement ajouter un deuxi\u00e8me \u00e9l\u00e9ment de tableau pour les attributs et un troisi\u00e8me \u00e9l\u00e9ment de tableau pour les blocs imbriqu\u00e9s (par exemple, les blocs Cover, Columns). Cela deviendra plus clair lorsque vous verrez le code.<\/p>\nCommen\u00e7ons simple. Supposons que nous ayons un register_post_type()<\/code>appel de fonction pour enregistrer un type de publication personnalis\u00e9 ‘ book<\/code>‘. Nous voulons pr\u00e9-remplir tous les nouveaux articles de ce type d’article avec un bloc de paragraphe avec un espace r\u00e9serv\u00e9 indiquant \u00e0 l’auteur ce qu’il ou elle doit \u00e9crire.<\/p>\nadd_action('init', function() {\n register_post_type('book', [\n 'label' => __('Books', 'txtdomain'),\n 'public' => true,\n ...\n 'template' => [\n ['core\/paragraph', ['placeholder' => __('Write your intro here...', 'txtdomain')]],\n ],\n ]);\n});<\/code><\/pre>\nNotez que le tableau d’attributs (avec ‘placeholder’ dedans) est facultatif. Maintenant, avec ce param\u00e8tre ‘template’ chaque fois que nous cr\u00e9ons de nouveaux articles, il sera cr\u00e9\u00e9 avec un bloc de paragraphe qui a l’espace r\u00e9serv\u00e9 "Ecrivez votre intro ici…".<\/p>\n
Prenons un exemple plus compliqu\u00e9: les blocs imbriqu\u00e9s. Supposons que nous voulions ajouter un bloc de couverture contenant un bloc de titre, un paragraphe et un bouton \u00e0 l’int\u00e9rieur, align\u00e9s au centre. Le titre et le paragraphe auront un espace r\u00e9serv\u00e9\u00a0:<\/p>\n
'template' => [\n ['core\/cover', ['align' => 'full', 'overlayColor' => 'blue-profile'], [\n ['core\/heading', ['align' => 'center', 'placeholder' => __('Call to action title', 'txtdomain')]],\n ['core\/paragraph', ['align' => 'center', 'placeholder' => __('Your text here', 'txtdomain')]],\n ['core\/button', ['align' => 'center']]\n ]],\n],<\/code><\/pre>\nL’image ci-dessous montre ce que nous obtiendrons lorsque nous cr\u00e9erons de nouveaux articles de livre. Cela a l’air moins intimidant qu’une toile vierge, n’est-ce pas ?<\/p>\n
![\"Comment](\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-152040-61e4d330dc012.png\")
<\/a><\/p>\nGardez \u00e0 l’esprit que les attributs sont diff\u00e9rents dans chaque type de bloc et peuvent \u00e9galement diff\u00e9rer dans votre configuration. Dans l’exemple de code ci-dessus, j’ajoute deux attributs au bloc Cover\u00a0; bloquer l’alignement sur "pleine largeur" \u200b\u200bet superposer la couleur sur une couleur pr\u00e9d\u00e9finie \u00e0 partir d’une palette de couleurs personnalis\u00e9e.<\/p>\n
![\"Comment](\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-152040-61e4d33596f0b.gif\")
<\/a><\/p>\n