Descubre en este tutorial cómo obtener y mostrar todas las categorías de patrones de bloques de una instalación de WordPress mediante código.
En una instalación de WordPress puede haber diversos patrones, algunos añadidos por el core de WordPress y otros por temas (y/o plugins). Por eso, es posible que en algunos casos te interese mostrar (u obtener) todas las categorías de patrones de bloques de una instalación de WordPress.
Con esta información puedes decidir si prefieres que algunos de ellos no se muestren y desregistrarlos para que no se muestren en el editor.
Y en este tutorial vas a aprender a hacer lo mismo pero con todas las categorías de patrones de bloques.
Dependiendo de la instalación el listado será diferente. Por ejemplo, este sería el resultado para una instalación de WordPress «pelada», una con un tema de OsomPress y otra con el tema Twenty Twenty-Two:
buttons columns featured gallery header text query
WordPress core
osom buttons columns featured gallery header text query
WordPress core + tema OsomPress
featured
footer
header
query
pages
buttons
columns
gallery
text
WordPress core + tema Twenty Twenty-Two
Vamos a ver cómo puedes conseguirlo.
Pasos para mostrar todas las categorías de patrones de bloques registrados en una instancia de WordPress mediante un shortcode
1. Crea el shortcode
Primero vas a encapsular el listado de categorías de patrones de bloques registrados dentro de un shortcode para poder mostrarlo donde quieras.
Añade el siguiente snippet al fichero functions.php o a tu plugin de funcionalidades:
Para ver este código y los otros 2063 snippets de esta web,
identifícate o suscríbete aquí.
Con este código creas un shortcode que te permite mostrar un listado con todos las categorías de patrones de bloques de la instalación de WordPress usando el shortcode [lista_categoria_patrones].
Para obtener el listado de temas utilizas la clase WP_Block_Pattern_Categories_Registry junto con los métodos get_instance y get_all_registered en combinación con un bucle (foreach).
En este caso, solo se muestra el nombre del patrón de bloque. En una instalación básica de WordPress el listado será así:
buttons columns featured gallery header text query
En cambio, si el tema añade sus propios patrones además de los nativos de WordPress verás los del tema. Algo así:
osom buttons columns featured gallery header text query
En este caso, se muestran también los que registra el tema de OsomPress Uprising (que añade la categoría «Osom»).
Pero, por ejemplo, el tema Twenty Twenty-Two al ser un tema de bloques añade una categoría llamada «footer».
featured footer header query pages buttons columns gallery text
Y curiosamente el tema Twenty Twenty-One añade una categoría «twentytwenty» que el Twenty Twenty-Two no registra.
Es decir, dependiendo del tema y los plugins que estés utilizando este listado cambiará.
Para poder ver el listado solo te queda un paso.
2. Introduce el shortcode donde quieras
La ventaja de los shortcodes es que puedes insertarlos en cualquier punto de la web.
Solo tendrás que escribir [lista_categoria_patrones] donde quieres que se visualice.
Conclusiones
Ahora ya sabes cómo obtener y mostrar una lista con todas las categorías de patrones de bloques registrados en una instalación de WordPress para decidir si los necesitas todos o no.
Si tienes alguna duda te leo en los comentarios. Y si quieres dejarme una sugerencia para futuros tutoriales, envíamela a través del formulario de contacto.
Todo ventajas de ser suscriptor. 😉
