Bloque de consulta de términos

El bloque Consulta de términos muestra una lista o cuadrícula de términos de taxonomía (como categorías, etiquetas o taxonomías personalizadas). Es especialmente útil en plantillas (por ejemplo, un índice de «Categorías» o una página de directorio) donde quieras enumerar términos y diseñar cómo aparece cada uno.

Requisitos

• WordPress 6.9 o posterior.
• Un tema de bloques para editar plantillas en el Editor del sitio.
• La taxonomía que quieras mostrar debe ser pública y estar disponible en el editor (show_in_rest activado).

Anatomía del bloque Consulta de términos

El inspector del bloque ofrece una descripción general rápida de la estructura del bloque Consulta de términos. Cada parte te da acceso a diferentes ajustes:

• Consulta de términos: Configura los parámetros de la consulta.
• Plantilla de término: Elige cómo se muestra el contenido, ya sea en formato de lista o cuadrícula.
• Nombre del término: Muestra el nombre del término.
• Descripción del término: Muestra la descripción del término.
• Recuento de términos: Muestra el número de resultados de cada término.

Añadir el bloque Consulta de términos a una plantilla

1. Ve a Apariencia > Editor.
2. Abre la plantilla donde quieras que aparezcan los términos (por ejemplo, una plantilla personalizada de «Categorías»).
3. Coloca el cursor en la ubicación deseada.
4. Abre el insertador de bloques (+), busca «Consulta de términos» y selecciónala.

Configuración del bloque

Después de añadir el bloque Consulta de términos verás dos opciones:

Estas variaciones ofrecen dos opciones de diseño diferentes:

• Nombre: solo muestra el nombre del término.
• Nombre y recuento: muestra el nombre y el número de elementos de ese término.

Cómo personalizar la apariencia

Hay numerosas formas de personalizar el bloque Consulta de términos, en parte porque está compuesto por bloques anidados que puedes reorganizar, añadir y mucho más. Cuando personalizas un bloque dentro del bloque Consulta de términos, los cambios se aplican a todos los bloques del mismo tipo. Mientras personalizas este bloque, puede ser útil usar la Vista de lista disponible en la barra de herramientas superior. Estas son algunas ideas de personalización para empezar:

• Puedes cambiar el ancho de varios elementos del bloque Consulta de términos.
• Puedes cambiar la alineación de los bloques dentro del bloque Consulta de términos.
• Puedes reorganizar los bloques como quieras, arrastrándolos y soltándolos o usando los controles de movimiento.
• Puedes cambiar el número de términos mostrados seleccionando el bloque Consulta de términos y ajustando la opción Máximo de términos en los ajustes del bloque.
• Puedes establecer diversas opciones de color para los bloques anidados.
• Puedes cambiar cómo se muestra el número de términos seleccionando el bloque Número de términos y cambiando el formato en la barra de herramientas del bloque.
• Puedes mostrar la descripción del término seleccionando el bloque Descripción del término y ajustando los estilos según sea necesario.

Barra de herramientas del bloque

Para ver la barra de herramientas del bloque, haz clic en el bloque y se mostrará la barra de herramientas. Cada bloque tiene iconos únicos en la barra de herramientas y controles de usuario específicos del bloque que te permiten manipularlo directamente en el editor. El bloque Consulta de términos incluye lo siguiente:

• Transformar en.
• Alinear: ninguna, ancho amplio o ancho completo.
• Mover/arrastrar para cambiar su posición en la plantilla.
• Más opciones (duplicar, bloquear, eliminar, etc.).

Transformar en

Haz clic en el botón «Transformar» para convertir el bloque Bucle de consulta en un bloque «Grupo» o «Columnas».  

Icono de arrastre

Para arrastrar y soltar el bloque en una nueva ubicación, haz clic y mantén pulsado el rectángulo de puntos y, a continuación, arrástralo a la nueva ubicación. La línea azul separadora indica dónde se colocará el bloque. Suelta el botón izquierdo del ratón cuando encuentres la nueva ubicación donde colocar el bloque.

Flechas de movimiento

Los iconos de flecha hacia arriba y hacia abajo se pueden usar para mover el bloque hacia arriba y hacia abajo en la página.

Puedes encontrar instrucciones detalladas sobre cómo mover un bloque dentro del editor aquí

Alinear

Usa la herramienta de cambio de alineación para alinear el bloque Bucle de términos. Elige una de las siguientes opciones:

• Ninguna – deja el bloque con su tamaño actual.
• Ancho amplio – aumenta el ancho del bloque más allá del tamaño del contenido.
• Ancho completo – extiende el bloque para cubrir todo el ancho de la pantalla.

Los ajustes de alineación «Ancho amplio» y «Ancho completo» deben estar activados por tu tema de WordPress. 

Vista de lista (predeterminada)

Muestra los términos en una lista apilada. Selecciona el bloque Plantilla de término para editarla.

Vista de cuadrícula

Muestra los términos en una cuadrícula. Selecciona el bloque Plantilla de término para editarla.

Opciones

El botón Opciones de la barra de herramientas de un bloque te ofrece más funciones para personalizarlo. 

Lee información sobre estos y otros ajustes.

Ajustes del bloque

Los bloques internos usan el ancho del contenido

Esta opción te permite configurar los ajustes de justificación, contenido y ancho amplio para todos los bloques anidados dentro del bloque Bucle de consulta.

Ordenar por

• Nombre: de A a Z
• Nombre: de Z a A
• Recuento: de mayor a menor
• Recuento: de menor a mayor

Términos seleccionados

Esta opción te permite elegir taxonomías específicas para mostrar. Simplemente busca y selecciona lo que quieras añadir.

Mostrar términos vacíos

Esta opción te permite mostrar términos incluso si están vacíos. Está desactivada de forma predeterminada.

Mostrar términos anidados

Esta opción te permite mostrar términos anidados. Está desactivada de forma predeterminada.

Máximo de términos

Esta opción te permite limitar el número de términos que quieres mostrar. Para mostrar todos los términos, usa 0 (cero).

Ajustes avanzados

La pestaña avanzada te permite añadir una clase CSS a tu bloque, lo que te permite escribir CSS personalizado y diseñar el bloque como quieras. También te permite asignar un elemento HTML.

Demostración

Consejos

• Usa Lista para taxonomías jerárquicas; usa Cuadrícula para revisar rápidamente muchos términos.
• Mantén destacado el nombre del término; añade la descripción del término para proporcionar contexto en las páginas de destino.
• Usa Ocultar vacíos para evitar archivos vacíos y mantener la lista relevante.
• Guarda una sección de Consulta de términos configurada como un Patrón para reutilizarla en distintas plantillas.

Preguntas frecuentes

¿Puedo mostrar solo términos de nivel superior?

• Sí. Deja Padre sin establecer y desactiva Incluir sub términos.

¿Puedo mostrar una taxonomía personalizada?

• Sí, si es pública y está registrada para mostrarse en el editor (show_in_rest true).

¿Puedo enlazar el nombre del término con su archivo?

• El nombre del término normalmente enlaza con el archivo del término de forma predeterminada. Puedes controlar enlaces adicionales (como el recuento de términos) en los ajustes de su bloque.