pom_theme_update_global_css: actualizar el CSS global

Reemplaza la hoja de estilos personalizada global de POM Theme y reconstruye el CSS compilado del sitio.

Argumentos

Permisos

Allow POM Theme writes abierto, además de manage_options.

Reemplaza, no añade

css se convierte en la hoja de estilos global completa. Todo lo que haya ahora y no esté en lo que envíes se pierde.

Este es el error que le cuesta una tarde a la gente: pedir «una regla para ocultar la barra lateral en móvil» y recibir una hoja de estilos que solo contiene esa regla, con dos años de estilos acumulados borrados.

La forma segura de la petición nombra el archivo completo:

Lee el CSS global y luego vuelve a escribirlo con esta regla añadida al final. Muéstrame la hoja de estilos completa antes de escribir.

Léelo primero y guarda la copia

Los ajustes del tema no tienen historial de revisiones. La salida de pom_theme_get_global_css, tomada antes de la escritura, es la única vía de vuelta.

Guárdala fuera de la conversación. El before de una simulación tiene el mismo contenido, pero una conversación no es una copia de seguridad.

La simulación es real

Devuelve before — la hoja de estilos actual completa — y after, exactamente lo que se almacenaría. Ambas son el CSS real.

También ejecuta primero la validación, de modo que una simulación te dice si el contenido sería rechazado sin escribir nada.

Compara las dos. Para una escritura que reemplaza todo, esa diferencia es toda la revisión.

Qué se rechaza

El CSS que contenga etiquetas de apertura PHP o una etiqueta de cierre </style> devuelve pom_ai_mcp_css_denied.

Esa comprobación es deliberadamente estrecha: bloquea las dos maneras en que una hoja de estilos podría dejar de ser una hoja de estilos. No es un validador de CSS. El CSS sintácticamente roto se acepta y se guarda.

Una llave que falte puede, por tanto, romper el estilo de todas las páginas del sitio, y nada en la respuesta lo dirá. Comprueba el sitio renderizado, no solo la respuesta de la herramienta.

La escritura reconstruye website.min.css

Tras guardar, se dispara la rutina de guardado del tema y los recursos CSS se regeneran. La respuesta incluye los metadatos de recursos resultantes, para que confirmes que la reconstrucción se ha producido y veas el nuevo tamaño de archivo y la marca de tiempo.

Si los metadatos muestran una marca de tiempo sin cambios, la reconstrucción no se ejecutó y el sitio sigue sirviendo la hoja de estilos compilada anterior.

Luego purga la caché

La reconstrucción produce un archivo nuevo; las cachés sirven el anterior. Una caché de páginas, una CDN y los navegadores necesitan vaciarse antes de que nadie vea el cambio.

Actualiza el CSS global y luego limpia la caché del sitio.

Consulta Limpiar la caché después de un cambio.

Considera los fragmentos como alternativa

Si el CSS personalizado del sitio es una única hoja de estilos global larga, cada cambio la reescribe toda y cada cambio arriesga toda ella.

pom_theme_upsert_custom_css almacena fragmentos con nombre que se editan y eliminan individualmente. Para cualquier pieza de estilo diferenciada — un banner de campaña, una variación estacional — un fragmento es el lugar más seguro.

Reserva la hoja de estilos global para reglas genuinamente globales del sitio.

Después de escribir

1. Vuelve a leer el CSS global y confirma que está completo, no solo la regla nueva.
2. Comprueba que la marca de tiempo de la hoja de estilos generada se ha movido.
3. Purga la caché y la CDN.
4. Carga varios tipos de página, incluida una que no pretendías afectar.

El paso 4 importa porque el CSS global es global: un selector pensado para el blog puede alcanzar el checkout.

Problemas comunes

Relacionado

• pom_theme_get_global_css — léelo y consérvalo primero
• pom_theme_upsert_custom_css — la alternativa más segura
• pom_theme_get_generated_css — confirma la reconstrucción