pom_theme_list_html_templates: listar plantillas HTML
Devuelve todas las plantillas personalizadas del sitio, de los tres tipos, con su marcado.
Argumentos
Ninguno.
Permisos
mcp:read y pom_theme:read, además de edit_theme_options.
Qué devuelve
Tres listas — archive, single y feed — además de merge_tag_sources.
Cada plantilla incluye:
| Campo | Significado |
|---|---|
repeater_identifier |
El ID que necesita cualquier otra herramienta |
template_name |
La etiqueta legible |
template_html |
El marcado, resuelto desde su archivo |
css_stylesheets |
Fragmentos de CSS adjuntos a esta plantilla |
js_scripts |
Scripts adjuntos a esta plantilla |
El marcado se resuelve por ti, de modo que una sola llamada te da el HTML completo de cada plantilla.
Es la única fuente de identificadores de plantilla
pom_theme_get_html_template, pom_theme_upsert_html_template, pom_theme_delete_html_template y pom_theme_assign_template funcionan todas mediante identificador, y ninguna de ellas encontrará una por nombre.
Lista las plantillas y muéstrame cada tipo, nombre e identificador.
Actualiza la lista antes de cualquier escritura. Los identificadores de una conversación larga que vienen de antes son la causa habitual de que se reemplace la plantilla equivocada.
Los nombres no son únicos ni significativos para el sistema
Dos plantillas pueden compartir un nombre. Lo que las distingue es el identificador, y es una cadena opaca.
Si una solicitud nombra una plantilla y dos coinciden, dilo en lugar de elegir.
No dice qué está en uso
Esta es la laguna que conviene conocer. El listado muestra lo que existe; no dice nada sobre lo que se renderiza.
Un sitio puede tener nueve plantillas de archivo con una asignada. Eliminar una plantilla sin asignar es inofensivo; eliminar la asignada cambia el sitio. Solo pom_theme_get_template_assignments te dice cuál es cuál.
Lee ambas antes de cualquier limpieza:
Lista las plantillas y las asignaciones, y dime qué plantillas no se usan.
css_stylesheets y js_scripts son adjuntos
Las plantillas hacen referencia a CSS gestionado y a scripts existentes que se cargan cuando la plantilla se renderiza. El listado muestra las referencias guardadas de forma nativa, que pueden ser rutas, URLs existentes o tokens de característica, sin el código fuente. Omite los campos de activos sin cambios en las escrituras. Las nuevas selecciones usan identificadores exactos del catálogo en vivo correspondiente, incluido pom_theme_get_script_catalog con target: template para los scripts.
Eso importa al mover una plantilla entre sitios: el marcado viaja, los activos referenciados no, y una plantilla cuyos identificadores de CSS no apuntan a nada se renderiza sin estilos.
merge_tag_sources apunta a las definiciones propias del tema
La respuesta nombra los archivos del tema donde se definen las etiquetas de combinación, uno por tipo de plantilla, más el analizador.
Son un puntero para desarrolladores que leen el código fuente del tema. Para escribir plantillas, usa en su lugar los recursos de etiquetas de combinación — archive, single, feed — que enumeran las propias etiquetas.
La respuesta puede ser grande
El marcado completo de cada plantilla, en una sola carga. En un sitio con muchas plantillas esto es mucho HTML.
Pide lo que necesitas:
Lista las plantillas y muéstrame solo los nombres e identificadores, agrupados por tipo.
Cómo usarla bien
Auditoría:
Lista las plantillas y dime cuáles usan
{{archive_results}}.
Antes de crear una:
¿Existe ya una plantilla de archivo que haga algo similar?
Problemas habituales
| Síntoma | Causa |
|---|---|
| Falta la herramienta | POM Theme no está disponible |
pom_ai_mcp_forbidden |
Falta edit_theme_options |
| Las tres listas están vacías | No hay plantillas personalizadas; están en uso los diseños integrados del tema |
| El marcado de una plantilla está vacío | Su archivo falta o no se puede leer |
| Dos plantillas con el mismo nombre | Permitido; usa los identificadores |
| No puedes distinguir cuál está en vivo | Lee las asignaciones |