pom_theme_get_custom_css: leer CSS personalizado gestionado
Enumera los fragmentos de CSS con nombre de POM Theme, con sus contenidos.
Argumentos
Ninguno. Devuelve todos los fragmentos.
Permisos
mcp:read y pom_theme:read, además de edit_theme_options.
Qué devuelve
items, uno por fragmento. Cada uno lleva:
| Campo | Significado |
|---|---|
repeater_identifier |
El ID del fragmento: necesario para actualizarlo o eliminarlo |
stylesheet_name |
La etiqueta legible |
css_code |
El archivo almacenado y su contenido resuelto |
last_change |
Cuándo se escribió por última vez, como marca de tiempo |
Los contenidos se resuelven por ti, de modo que obtienes el CSS real en lugar de una ruta de archivo.
repeater_identifier es el identificador para todo lo demás
Tanto pom_theme_upsert_custom_css como pom_theme_delete_custom_css funcionan por identificador. Esta es la única herramienta que te dice cuáles son.
Son cadenas generadas, no nombres. Trabajar a partir de una lista desactualizada es la forma en que se sobrescribe el fragmento equivocado:
Enumera los fragmentos de CSS y muéstrame cada identificador con su nombre.
Consíguelos al día antes de cualquier escritura.
Los nombres no son únicos
Nada impide que dos fragmentos se llamen "Header fixes". El identificador los distingue; el nombre no.
Así que una petición formulada como «actualiza el fragmento de cabecera» es ambigua siempre que exista un duplicado. Haz coincidir por el identificador y, si dos fragmentos comparten un nombre, dilo en lugar de elegir uno.
last_change te dice qué es trabajo activo
La marca de tiempo se escribe en cada guardado a través de estas herramientas. Un fragmento modificado esta mañana probablemente es trabajo en curso de alguien; uno que lleva dos años intacto probablemente es seguro de consolidar.
Es la única señal de actualidad disponible: los fragmentos no tienen autor ni historial de revisiones.
Fragmentos frente a la hoja de estilos global
Ambos terminan en el mismo resultado compilado. La diferencia es cómo se gestionan:
- La hoja de estilos global es un solo bloque. Cada escritura reemplaza todo su contenido.
- Los fragmentos son direccionables individualmente. Una escritura toca uno y deja el resto intacto.
Eso hace que los fragmentos sean el lugar más seguro para cualquier cosa separable. Este listado es cómo averiguas qué modelo usa realmente un sitio: un sitio con una hoja de estilos global gigante y sin fragmentos es uno en el que cada cambio de CSS es de alto riesgo.
El orden no equivale a una prioridad de cascada en la que puedas confiar
Los fragmentos se compilan en la hoja de estilos del sitio, y las reglas de cascada de CSS se aplican al resultado. Si dos fragmentos establecen la misma propiedad en el mismo selector, cuál gana depende del orden compilado y de la especificidad, no del orden en que aparecen en este listado.
No resuelvas un conflicto reordenando. Haz que la regla pretendida sea más específica o consolida los dos fragmentos.
Leer antes de escribir
Los fragmentos no tienen revisiones. Esta respuesta es el único registro del contenido de un fragmento antes de que una operación de inserción o actualización lo reemplace.
Enumera los fragmentos y luego muéstrame el CSS completo del que se llama "Campaign banner".
Usarlo bien
Auditoría:
Enumera cada fragmento de CSS con su nombre, identificador y tamaño, y dime cuáles parecen redundantes.
Diagnóstico:
¿Qué fragmento contiene una regla para
.site-header?
Esa segunda pregunta tiene respuesta porque los contenidos están resueltos: puedes buscar en todos los fragmentos con una sola llamada.
Problemas comunes
| Síntoma | Causa |
|---|---|
| Falta la herramienta | POM Theme no está disponible |
pom_ai_mcp_forbidden |
Falta edit_theme_options |
| Una lista vacía | No existen fragmentos; comprueba la hoja de estilos global |
| El contenido de un fragmento está vacío | Su archivo falta o no se puede leer |
| Dos fragmentos con el mismo nombre | Permitido; usa los identificadores |
| El estilo del sitio no está en ningún fragmento | Es CSS global, del Personalizador o de un plugin |