web_taxonomy_terms_list Shortcode
El web_taxonomy_terms_list shortcode crea un directorio alfabético de los términos públicos actuales de una taxonomía. Agrupa los enlaces de archivo por sus nombres mostrados y puede añadir un índice para saltar entre los grupos con contenido. Por defecto incluye toda la taxonomía coincidente; no pagina. El bloque nativo tiene un límite de términos explícito aparte.
Page Builder expone taxonomía, términos vacíos, enlaces de retorno, máximo de términos, ancla y clases auxiliares. Los atributos adicionales de alfabeto y accesibilidad que aparecen a continuación también se admiten en la sintaxis sin procesar. Para editar con el bloque nativo, usa Taxonomy Terms List.
Uso
[web_taxonomy_terms_list post_type_taxonomies="post_tag" show_empty_terms="yes" show_top_links="yes" limit="200"]Atributos
| Atributo | Predeterminado | Valores aceptados | Propósito |
|---|---|---|---|
post_type_taxonomies |
— | Slug de taxonomía pública y consultable públicamente distinto de post_format |
Selecciona el directorio. Las taxonomías ausentes o no disponibles no muestran nada. |
show_empty_terms |
— | yes o vacío |
Incluye los términos con recuento cero. Cuando está desactivado, WordPress también incluye los padres cuyos descendientes contienen contenido publicado. |
show_top_links |
— | yes o vacío |
Añade enlaces de volver arriba después de los grupos de letras y números. |
limit |
0 |
Entero no negativo | Máximo opcional, seleccionado por nombre antes del agrupamiento alfabético. Cero mantiene toda la taxonomía. |
navigation |
yes |
yes o no |
Muestra la navegación por letras. |
empty_letters |
yes |
yes o no |
Muestra las entradas A–Z y numéricas sin usar como texto inactivo. |
fold_accents |
yes |
yes o no |
Agrupa las iniciales latinas acentuadas con A–Z. Los demás alfabetos conservan sus iniciales; los símbolos usan #. |
number_group |
individual |
individual o combined |
Usa un grupo por dígito o un único grupo 0–9 grupo. |
heading_tag |
h3 |
h2–h6 |
Nivel semántico del encabezado del grupo; el tamaño visual se mantiene como H3. |
accessible_name |
Etiqueta de la taxonomía + «index» | Texto sin formato | Nombra el directorio y su navegación para la tecnología de asistencia. |
device_visibility |
— | Cadena salvo que se indique lo contrario | Aplica la regla de visibilidad adaptable seleccionada. |
el_id |
— | ID HTML único válido | Introduce el ID de la sección (Nota: asegúrate de que sea único y válido según la especificación w3c). |
el_class |
— | Cadena salvo que se indique lo contrario | Si deseas aplicar un estilo diferente a un elemento de contenido concreto, usa este campo para añadir un nombre de clase y luego haz referencia a él en tu archivo css. |
El primer directorio de shortcode sin un ancla redactada conserva #terms_a_z. El primer grupo de shortcode para cada letra latina o dígito conserva #terms-a–#terms-z o #terms-0–#terms-9. Los grupos repetidos y los bloques nativos usan destinos únicos, y la navegación de cada directorio enlaza a sus propios grupos. Los enlaces de retorno llevan al inicio de ese directorio. Los nombres y las URL de archivo se resuelven cuando se renderiza la página; borra las cachés de página después de cambiar los términos si es necesario. El shortcode sigue renderizándose con la interfaz de administración Legacy Page Builder desactivada.
Personaliza la hoja de estilos
Ve a Settings → POM Theme → Advanced → Custom CSS → Shortcode CSS assets → Taxonomy terms list para comparar el código fuente actual de taxonomy-terms-list.min.css con una versión editable. Al guardar se crea un reemplazo minimizado por sitio para el handle existente web-taxonomy-terms-list handle. El web_taxonomy_terms_list shortcode, la taxonomía seleccionada, el filtrado de términos vacíos, los grupos A–Z y 0–9, los enlaces del índice, los enlaces de volver arriba, los destinos de archivo, los atributos y la carga condicional permanecen sin cambios. Este módulo no tiene JavaScript asociado. Revert to theme CSS elimina el reemplazo y restaura el activo actual del tema.
Verificación
Prueba términos que empiezan por letras y dígitos, incluidas letras sin términos coincidentes. Verifica que los enlaces activos del índice lleguen al grupo correcto, que los caracteres inactivos no sean enlaces, que los destinos de archivo sean correctos y que los enlaces opcionales de volver arriba funcionen con la navegación por teclado.