pom_theme_get_html_template: obtener una plantilla HTML

Lee una única plantilla por tipo e identificador.

Argumentos

Permisos

mcp:read y pom_theme:read, además de edit_theme_options.

Ambos argumentos deben coincidir

El identificador se busca dentro del tipo indicado. Un identificador de plantilla de archivo pasado con template_type: single devuelve pom_ai_mcp_template_not_found — la plantilla existe, solo que no donde la buscaste.

Así que un error de no encontrada significa una de dos cosas: el identificador está mal, o el tipo lo está. Comprueba ambos en pom_theme_list_html_templates, que agrupa las plantillas por tipo y hace evidente el emparejamiento.

Cualquier cosa distinta de los tres tipos válidos devuelve pom_ai_mcp_invalid_template_type en su lugar, lo cual es un fallo más claro.

Qué devuelve

La fila de la plantilla: repeater_identifier, template_name, el template_html resuelto, y las selecciones de css_stylesheets y js_scripts adjuntas a ella.

Misma forma que una entrada del listado. La diferencia es el alcance — una plantilla en lugar de todas.

Cuándo usarla en lugar del listado

El listado ya devuelve el marcado completo de todo, así que esta herramienta no sirve para obtener más detalle. Sirve para obtener menos:

• Un sitio con veinte plantillas devuelve un listado muy grande; esta devuelve una.
• Tras una escritura, para confirmar qué se almacenó realmente.
• Cuando tienes un identificador de una asignación y solo necesitas esa plantilla.

Este último caso es el habitual:

Lee las asignaciones y luego lee la plantilla de archivo que está asignada actualmente.

Lee antes de cada sustitución

pom_theme_upsert_html_template sustituye todo el marcado, y las plantillas no tienen historial de revisiones.

Esta respuesta es la única copia de lo que una escritura sobrescribiría. Consérvala fuera de la conversación antes de editar nada en vivo.

Leer es cómo aprendes las convenciones del sitio

Las plantillas existentes muestran qué etiquetas de combinación usa realmente este sitio, cómo se escriben los condicionales y qué nombres de clase espera el CSS.

Escribir una plantilla nueva que se ajuste a esas convenciones tiene muchas más probabilidades de renderizarse correctamente que una escrita solo a partir de la referencia de etiquetas de combinación:

Lee la plantilla de archivo actual y luego propón una nueva que siga la misma estructura.

Los recursos adjuntos usan referencias nativas

Estos campos contienen las referencias de recursos guardadas del tema, que pueden ser rutas gestionadas, URL de scripts existentes o tokens de funciones nativas. No contienen código fuente. Omite los campos de recursos sin cambios al actualizar una plantilla. Para sustituir una selección, usa los identificadores de hojas de estilo del catálogo CSS y los identificadores de scripts de pom_theme_get_script_catalog con target: template; las rutas y URL arbitrarias no se aceptan como entradas de escritura. Para ver qué contiene una hoja de estilo referenciada, léela con pom_theme_get_custom_css y haz coincidir el identificador.

Una plantilla que se renderiza sin estilos suele tener referencias apuntando a fragmentos que ya no existen.

No te dice si esta plantilla está activa

Nada en la respuesta indica si hay algo asignado a ella. Usa pom_theme_get_template_assignments para eso.

Editar una plantilla que resulta estar asignada es un cambio en vivo en el sitio; editar una no asignada no lo es. Sabes cuál es antes de escribir.

Problemas comunes

Relacionado

• pom_theme_list_html_templates — obtener el identificador
• pom_theme_upsert_html_template
• pom_theme_get_template_assignments