pom_theme_generate_assets: regenerar los assets del tema

Reconstruye el CSS generado de POM Theme — y su JavaScript, si el generador completo está disponible.

Argumentos

Permisos

Permitir escrituras de POM Theme abierto, más manage_options. Se clasifica como escritura aunque no cree nada nuevo — reemplaza archivos que el sitio sirve.

Dos generadores, y obtienes el que exista

Si el generador de assets completo del tema está disponible, se ejecuta y reconstruye el CSS y el JavaScript. Si no, la herramienta recurre a una reconstrucción solo de CSS.

La ejecución de prueba informa de cuál se ejecutaría, y pom_theme_get_status informa de ambos por adelantado bajo assets_helpers.

Esa distinción importa cuando el JavaScript es el problema: en un sitio donde solo existe la ruta de solo CSS, esta herramienta nunca corregirá un script obsoleto, y ninguna cantidad de reejecuciones lo hará.

Haz una ejecución de prueba de la generación de assets y dime qué generador tiene este sitio.

Normalmente no necesitas llamarla

Las herramientas de escritura de CSS regeneran los assets automáticamente. Después de pom_theme_update_global_css, pom_theme_upsert_custom_css o pom_theme_delete_custom_css, la reconstrucción ya ha ocurrido y la respuesta incluye los metadatos del archivo resultante.

Llamarla después es inofensivo y redundante.

Cuándo es la herramienta adecuada

• La hoja de estilos generada falta. Común tras una migración: la base de datos llegó, los archivos generados no.
• Un cambio de ajustes no apareció. Los colores, la tipografía, los botones y el estilo de la cabecera se compilan en la hoja de estilos; un cambio hecho fuera de estas herramientas puede no haber disparado una reconstrucción.
• Una compilación parcial. La hoja de estilos existe pero es sospechosamente pequeña.
• Después de activar una función del tema cuyo CSS solo se compila cuando la función está en uso.

En cada caso, comprueba pom_theme_get_generated_css antes y después, y compara filemtime y size.

Sobrescribe la hoja de estilos en vivo

El sitio sirve el resultado inmediatamente. Si la compilación falla a medias, los visitantes obtienen una hoja de estilos rota o truncada, y no hay una versión anterior a la que recurrir.

Ese es un riesgo pequeño en un sitio sano y real donde el directorio de uploads está casi lleno o los permisos son justos. En un sitio de producción con mucho tráfico, prefiere un momento tranquilo.

Reconstruye a partir de los ajustes actuales

La salida refleja los ajustes del tema tal como están ahora. Si alguien ha estado editando ajustes en el admin sin guardar, o si un ajuste está en un estado inesperado, esto graba ese estado en la hoja de estilos.

No es una herramienta de reparación. No puede recuperar CSS que fue sobrescrito, y no valida nada — el CSS personalizado no válido se compila exactamente como está almacenado.

Después purga la caché

Un archivo reconstruido no es un cambio visible. La caché de página, la CDN y los navegadores necesitan limpiarse.

Regenera los assets del tema y luego limpia la caché del sitio.

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

Si no ayuda

La reconstrucción produjo un archivo actual y el sitio sigue viéndose mal. Eso ahora es un problema de caché o un problema de CSS, no un problema de compilación — y reejecutar esta herramienta no cambiará ninguno de los dos.

Comprueba la cadena de versión del asset y luego el CSS fuente.

Después de ejecutarla

1. Lee el CSS generado y confirma que filemtime se movió y que size es plausible.
2. Purga la caché y la CDN.
3. Carga varios tipos de página, incluida una con un estilo específico de función.

Problemas comunes

Relacionado

• pom_theme_get_generated_css — verifica antes y después
• pom_theme_get_status — qué generador existe
• pom_theme_get_css_build_info