allowed_block_types<\/code>. Este filtro te da dos par\u00e1metros; una matriz de todos los bloques y el objeto de publicaci\u00f3n. Todo lo que tenemos que hacer es administrar la matriz antes de devolverla. Y debido a que tambi\u00e9n obtenemos el objeto de publicaci\u00f3n en el filtro, tambi\u00e9n podemos agregar reglas por tipo de publicaci\u00f3n u otra metainformaci\u00f3n de publicaci\u00f3n.<\/p>\nLa matriz de bloques consta de cadenas de nombres con espacio de nombres del bloque. Todos los bloques en WordPress requieren un espacio de nombres prefijado antes del nombre del bloque. Para los bloques principales de WordPress, el espacio de nombres es " core\/<\/code>" y para los bloques incrustados de WordPress, el espacio de nombres es " core-embed\/<\/code>". Por ejemplo, el bloque de encabezado tiene el nombre " core\/heading<\/code>" en esta matriz. Cre\u00e9 una descripci\u00f3n general completa de los nombres de todos los tipos de bloques en mi publicaci\u00f3n sobre C\u00f3mo para acceder y analizar los bloques de una publicaci\u00f3n<\/a>.<\/p>\nAqu\u00ed hay un ejemplo r\u00e1pido del uso del filtro para eliminar todos los bloques excepto el p\u00e1rrafo. Esto se aplicar\u00e1 a todos los tipos de publicaciones.<\/p>\n
add_filter('allowed_block_types', function($block_types, $post) {\n return ['core\/paragraph'];\n}, 10, 2);<\/code><\/pre>\nSi agrega este c\u00f3digo en su tema functions.php<\/code>o archivo de complemento, el resultado es que Gutenberg rechaza por completo cualquier otro bloque que no sea el p\u00e1rrafo. Ni siquiera podr\u00e1s ver ning\u00fan otro bloque, ni puedes intentar atraerlos escribiendo " \/<\/code>" en la publicaci\u00f3n (atajo de bloque) o busc\u00e1ndolos.<\/p>\n<\/p>\nPodemos definir los bloques que queremos mantener o eliminar por tipo de publicaci\u00f3n. Simplemente verificamos la propiedad post_type<\/code>en el objeto de publicaci\u00f3n. En el ejemplo de c\u00f3digo a continuaci\u00f3n, definimos una nueva matriz de los bloques que queremos permitir y agregamos esta regla solo para el tipo de publicaci\u00f3n personalizada ‘ 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>\nCon el c\u00f3digo anterior, obtiene todos los bloques al editar publicaciones y p\u00e1ginas, pero al editar el tipo de publicaci\u00f3n personalizado ‘ book<\/code>‘, solo puede agregar p\u00e1rrafos, encabezados e im\u00e1genes individuales.<\/p>\nUsa tu imaginaci\u00f3n para agregar tus propias reglas. Debido a que tenemos el objeto de publicaci\u00f3n, podemos acceder a la mayor parte de la informaci\u00f3n que necesitar\u00edamos. \u00bfQuiz\u00e1s necesite limitar las opciones de bloque por un valor meta de publicaci\u00f3n? Por ejemplo, por plantilla de p\u00e1gina elegida, categor\u00eda de publicaci\u00f3n elegida u otra cosa.<\/p>\n
Lista blanca<\/h3>\n
Por lo que puedo ver, solo puede incluir bloques en la lista blanca (decidir cu\u00e1les eliminar, en lugar de decidir cu\u00e1l conservar) anulando el registro de los bloques en un punto determinado. Y tienes que hacerlo con Javascript y no con PHP.<\/p>\n
No entrar\u00e9 en detalles sobre esto, pero deber\u00e1 poner en cola un archivo Javascript cargado init<\/code>o enqueue_block_editor_assets<\/code>enganchado, con wp-dom-ready<\/code>y wp-blocks<\/code>como dependencia. Dentro del script, puede configurar una variable de las que desea eliminar, siguiendo las mismas reglas para espacios de nombres y nombres de bloques anteriores. Y para cada nombre de bloque, llama a la funci\u00f3n unregisterBlockType()<\/code>del wp.blocks<\/code>paquete. Por lo general, deber\u00e1 hacer esto dentro de una funci\u00f3n wp.domReady()<\/code>para asegurarse de que el orden de carga del script sea correcto.<\/p>\nAlgo como esto:<\/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>\nEliminar tipos de bloques es una forma de controlar bloques en Gutenberg. Veamos la otra forma, quiz\u00e1s m\u00e1s divertida, de controlar los bloques: las plantillas de bloques.<\/p>\n
Plantillas de bloque<\/h2>\n
Otra forma de controlar los bloques de Gutenberg en WordPress es mediante el uso de plantillas de bloques. WordPress tiene una funcionalidad que le permite completar nuevas publicaciones con un conjunto de bloques predefinidos. Esto puede ser \u00fatil para ayudar a los autores mostr\u00e1ndoles una sugerencia de estructura de bloque. Tambi\u00e9n puede optar por bloquear estos bloques precargados, por lo que no permite que los autores reordenen o agreguen otros bloques. Esto es \u00fatil cuando desea que las publicaciones tengan una estructura y un dise\u00f1o espec\u00edficos; por ejemplo, asegurarse de que todas las publicaciones de ese tipo de publicaci\u00f3n tengan su informaci\u00f3n estructurada exactamente de la misma manera.<\/p>\n
Podemos agregar plantillas de bloque con un nuevo par\u00e1metro a la [register_post_type](https:\/\/developer.wordpress.org\/reference\/functions\/register_post_type\/)()<\/code>funci\u00f3n que se usa para registrar tipos de publicaciones personalizadas (nota: el nuevo par\u00e1metro a\u00fan no se ha agregado a la documentaci\u00f3n). Tambi\u00e9n puede agregar o ajustar los par\u00e1metros en los tipos de publicaciones existentes, como publicaciones y p\u00e1ginas; consulte c\u00f3mo hacerlo a continuaci\u00f3n.<\/p>\nEl nuevo par\u00e1metro para register_post_type()<\/code>es ‘ template<\/code>‘. Como valor para ‘ template<\/code>‘, debe proporcionar una matriz de bloques. Cada bloque tambi\u00e9n debe ser una matriz. Como m\u00ednimo, debe proporcionar el primer elemento de la matriz; el nombre del bloque (p. ej core\/paragraph<\/code>. ). Opcionalmente, puede agregar un segundo elemento de matriz para atributos y un tercer elemento de matriz para bloques anidados (por ejemplo, bloques de portada, columnas). Ser\u00e1 m\u00e1s claro cuando veas el c\u00f3digo.<\/p>\nComencemos de forma sencilla. Supongamos que tenemos una register_post_type()<\/code>llamada de funci\u00f3n para registrar un tipo de publicaci\u00f3n personalizada ‘ book<\/code>‘. Queremos completar previamente todas las publicaciones nuevas de este tipo de publicaci\u00f3n con un bloque de p\u00e1rrafo con un marcador de posici\u00f3n que le diga al autor lo que debe escribir.<\/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>\nTenga en cuenta que la matriz de atributos (con ‘marcador de posici\u00f3n’ en ella) es opcional. Ahora, con este par\u00e1metro de ‘plantilla’ cada vez que creamos nuevas publicaciones, se crear\u00e1 con un bloque de p\u00e1rrafo que tiene el marcador de posici\u00f3n "Escribe tu introducci\u00f3n aqu\u00ed…".<\/p>\n
Veamos un ejemplo m\u00e1s complicado: bloques anidados. Digamos que queremos agregar un bloque de Portada que tiene un bloque de t\u00edtulo, un p\u00e1rrafo y un bot\u00f3n dentro, alineado al centro. El t\u00edtulo y el p\u00e1rrafo tendr\u00e1n un marcador de posici\u00f3n:<\/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>\nLa siguiente imagen muestra lo que obtendremos cuando creemos nuevas publicaciones de libros. Parece menos intimidante que un lienzo en blanco, \u00bfverdad?<\/p>\n
![\"C\u00f3mo](\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-152040-61e4d330dc012.png\")
<\/a><\/p>\nTenga en cuenta que los atributos son diferentes en cada tipo de bloque y tambi\u00e9n pueden diferir en su configuraci\u00f3n. En el ejemplo de c\u00f3digo anterior, agrego dos atributos al bloque Portada; bloquee la alineaci\u00f3n a "Ancho completo" y superponga el color a un color predefinido de una paleta de colores personalizada.<\/p>\n
![\"C\u00f3mo](\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-152040-61e4d33596f0b.gif\")
<\/a><\/p>\n