• Saltar a la navegación principal
  • Saltar al contenido principal
Código Genesis

Código Genesis

Tutoriales de WordPress y Genesis Framework

  • Empieza aquí
  • Cuenta
    • Suscripción
    • Perfil
    • Actualizar tarjeta
    • Favoritos
    • Salir
  • Suscribirse
  • Acceder

Obtener un listado de las categorías de patrones de bloques registrados en un WordPress

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.

En un tutorial reciente te expliqué como puedes visualizar todos los patrones de bloques registrados en un WordPress.

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 1827 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 los temas 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.

Importante:

  • Si estás utilizando el editor clásico, utiliza la pestaña de HTML para introducir el shortcode.
  • En caso de que ya estés usando el nuevo editor de bloques (Gutenberg) puedes añadirlo al bloque normal de párrafo, el de HTML o el de shortcode. Todos ellos renderizarán de forma correcta el contenido.

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. 😉

Editor de bloques PHP Shortcode WordPress

Nahuai Badiola

Desarrollador web especializado en WordPress y Genesis Framework. CEO de Código Genesis y cofundador de OsomPress (temas y plugins para WordPress).

Para dejar dudas o preguntas sobre este código, puedes identificarte o suscribirte.

  • Empieza aquí
  • Sobre Código Genesis
  • Preguntas frecuentes
  • Contacto

Aviso legal · Política de privacidad · Política de cookies · Condiciones de contratación
Copyright © 2023 · Código Genesis

¿Has olvidado tu contraseña?