POM Theme referencia de herramientas de plantillas
Siete herramientas para las plantillas HTML personalizadas de POM Theme: el marcado que muestra archivos, entradas individuales y feeds de resultados.
Las herramientas
| Herramienta | Función | Escribe |
|---|---|---|
pom_theme_list_html_templates |
Lista todas las plantillas | |
pom_theme_get_html_template |
Lee una plantilla | |
pom_theme_upsert_html_template |
Crea o reemplaza una plantilla | Sí |
pom_theme_delete_html_template |
Elimina una plantilla | Sí |
pom_theme_get_template_assignments |
Qué plantilla muestra qué | |
pom_theme_assign_template |
Apunta un objetivo a una plantilla | Sí |
pom_theme_configure_content_model |
Construye tipos de entradas, campos y plantillas en conjunto | Sí |
Se registra solo cuando POM Theme está disponible. Compruébalo con pom_theme_get_status.
Permisos
| Requiere | |
|---|---|
| Ámbitos, lecturas | mcp:read, pom_theme:read |
| Ámbitos, escrituras | mcp:write, pom_theme:write |
| Capacidad, lecturas | edit_theme_options |
| Capacidad, escrituras | manage_options |
| Control de escritura | Allow POM Theme writes |
Tres tipos de plantilla
| Tipo | Muestra |
|---|---|
archive |
La página que lista las entradas de un tipo |
single |
Una entrada de ese tipo |
feed |
El elemento de resultado que se repite dentro de un archivo |
Toda herramienta que recibe un template_type acepta solo estos tres. Cualquier otra cosa devuelve pom_ai_mcp_invalid_template_type.
La distinción entre archive y feed es la que la gente suele confundir: el archivo es la página que rodea los resultados, y el feed es la tarjeta que se repite para cada resultado. Una plantilla de archivo normalmente contiene {{archive_results}} en el lugar donde se muestra la plantilla de feed.
Crear una plantilla no la muestra
Las plantillas y las asignaciones son cosas distintas. Una plantilla que creas no muestra nada hasta que algo se apunta a ella con pom_theme_assign_template.
Ese diseño en dos pasos es deliberado — te permite construir y revisar una plantilla antes de publicarla — y es la razón más habitual por la que una plantilla nueva "no funciona".
Las etiquetas de combinación son el lenguaje de las plantillas
Las plantillas son HTML más etiquetas de combinación: bloques {{title}}, {{archive_results}}, {{if}}. Las etiquetas disponibles difieren según el tipo de plantilla.
Están documentadas como recursos MCP, uno por tipo:
- Etiquetas de combinación de archivo
- Etiquetas de combinación de entrada individual
- Etiquetas de combinación de feed
Lee la adecuada antes de escribir el marcado. Una etiqueta que no existe para ese tipo falla en la validación.
Las plantillas se validan antes de guardarse
A diferencia del CSS, el marcado de las plantillas se comprueba de verdad: las etiquetas de combinación desconocidas, los bloques {{if}} no equilibrados y el marcado vacío son errores que bloquean la escritura; los <script> y <style> en línea son avisos.
Las etiquetas PHP se rechazan de plano con pom_ai_mcp_template_php_denied. Una validación fallida devuelve pom_ai_mcp_template_validation_failed con los problemas concretos.
Eso convierte a las plantillas en la única parte de POM Theme donde una escritura incorrecta suele detectarse antes de que llegue al sitio.
Las asignaciones también se validan
No puedes asignar una plantilla que no existe, ni una del tipo equivocado, ni apuntar a un tipo de entrada que no esté registrado. Cada caso tiene su propio error, que aparece en la página de asignación.