pom://theme/mergetags/archive: valores estructurados de archivo
Este recurso JSON es la fuente de verdad legible por máquina para las etiquetas de combinación de archivo. Su carga útil contiene el contexto de archive, un mapa de mergetags y la sintaxis de rules.
Conceptos de archivo disponibles
El catálogo expone:
- salida común:
icon,translatable_string; - identidad del archivo:
archive_title,blogname; - datos de término:
term_id,parent_term_id,term_description,term_thumbnail,term_bg_image,term_color; - inserción de resultados:
archive_results.
Las plantillas de archivo no anuncian las etiquetas de control if, else y /if disponibles en los contextos de artículo individual y de feed. No copies esos controles a una plantilla de archivo a menos que un catálogo en vivo posterior los añada de forma explícita.
Elección de etiquetas
Usa archive_title para el encabezado actual del archivo. Las etiquetas específicas de término pueden no devolver contenido cuando el archivo actual no esté respaldado por un término consultado. parent_term_id admite su comportamiento de alternativa documentado; inspecciona la definición de la etiqueta en vivo antes de depender de ella. Usa archive_results para el bucle en lugar de intentar consultar o renderizar entradas dentro de la plantilla.
Las etiquetas de combinación usan llaves dobles:
{{term_thumbnail}}
{{icon family="feather" name="grid"}}
{{translatable_string text=%%Browse this category%%}}
Usa exactamente las definiciones de atributos devueltas. Cuando un atributo contenga texto largo, comillas, HTML u otra etiqueta de combinación, envuelve su valor literal en %%...%%.
El catálogo indica al cliente qué se puede renderizar, no si un archivo concreto tiene metadatos de término rellenados. Valida el marcado y, a continuación, previsualiza tanto un archivo de término como cualquier archivo que no sea de término al que se vaya a asignar la plantilla.
Guías relacionadas: recurso de plantilla de archivo, herramienta de autoría de etiquetas de combinación y validación de plantillas.