pom_theme_delete_custom_css: eliminar CSS personalizado gestionado
Elimina un fragmento de CSS. Está marcado como destructivo y no existe papelera desde la que recuperarlo.
Argumentos
| Argumento | Obligatorio | Significado |
|---|---|---|
repeater_identifier |
Sí | El fragmento que se va a eliminar |
dry_run |
No | Informa sin eliminar |
Permisos
Permitir escrituras de POM Theme abiertas, además de manage_options.
No hay deshacer
Los fragmentos no tienen historial de revisiones ni papelera. Una vez eliminados, la fila desaparece del ajuste.
La única copia de su CSS es lo que pom_theme_get_custom_css devolvió antes de que lo eliminaras. Léelo, consérvalo fuera de la conversación y luego elimínalo:
Muéstrame el CSS completo de ese fragmento. Quiero conservarlo antes de que lo elimines.
Un identificador incorrecto informa de éxito
Esta es la peculiaridad que conviene conocer. La herramienta filtra la lista de fragmentos por identificador e informa de deleted como si el recuento cambió.
Así, eliminar un identificador que no existe devuelve deleted: false — no un error, no un 404. Una respuesta de deleted: false significa que no se eliminó nada, y la causa habitual es un identificador obsoleto o mal escrito.
Lee el valor de la respuesta en lugar de asumir que la llamada que tuvo éxito significa que el fragmento se eliminó.
La ejecución de prueba cuenta filas
Devuelve before_count y after_count — cuántos fragmentos existen ahora y cuántos quedarían.
Recuentos iguales significan que el identificador no coincidió con nada, que es exactamente el caso que conviene detectar antes de una llamada real. Una diferencia de uno confirma que el identificador se resuelve.
Lo que no muestra es qué fragmento, ni su contenido. Confírmalo por separado desde el listado.
Confirma por contenido, no solo por nombre
Los nombres de los fragmentos no son únicos y los identificadores son cadenas opacas. Ambos hacen fácil eliminar el que no corresponde.
Lista los fragmentos, muéstrame el CSS del que planeas eliminar y espera a que confirme.
Para cualquier cosa en un sitio en vivo, ese paso de confirmación es toda la salvaguarda.
Vaciar un fragmento es la alternativa reversible
Si el objetivo es impedir que cierto CSS se aplique sin perder el registro, usa pom_theme_upsert_custom_css con el mismo identificador y contenido vacío, o con las reglas comentadas.
El fragmento permanece, su nombre permanece y restaurarlo es una sola escritura. Prefiere esto cuando el estilo pueda volver a necesitarse — una campaña de temporada, una prueba A/B.
Elimina solo los fragmentos que sean genuinamente obsoletos.
El CSS del sitio se regenera inmediatamente
Después de eliminar la fila, la rutina de guardado del tema se dispara y la hoja de estilos compilada se regenera sin ese fragmento. La respuesta incluye los metadatos del activo resultante.
El estilo desaparece del sitio en cuanto se vacían las cachés. No hay estado de borrador.
Eliminar un fragmento puede afectar a otros
Los fragmentos comparten una hoja de estilos compilada, por lo que el CSS de otros lugares puede haberse escrito asumiendo que una regla del fragmento eliminado estaba en vigor — una anulación que ahora no anula nada, o un diseño que dependía de un reinicio.
Después de eliminar, revisa páginas más allá de aquella para la que se nombró el fragmento.
Después de eliminar
- Comprueba que
deletedes true. - Lista los fragmentos y confirma que se eliminó el correcto.
- Confirma que la marca de tiempo de la hoja de estilos generada cambió.
- Purga la caché y luego carga varios tipos de página.
Problemas habituales
| Síntoma | Causa |
|---|---|
| La escritura se rechaza | POM Theme puerta de escritura cerrada |
pom_ai_mcp_forbidden |
Falta manage_options |
deleted es false |
El identificador no coincidió con nada |
| Los recuentos de la prueba son iguales | Misma causa; el identificador es incorrecto |
| Se eliminó el fragmento equivocado | Los nombres no son únicos; los identificadores son opacos |
| No se puede restaurar | Correcto; no hay papelera ni revisiones |
| El estilo se rompió en otra parte | Otro CSS dependía de las reglas eliminadas |
| El estilo sigue visible | Caché o CDN |
Relacionado
pom_theme_get_custom_css— léelo y consérvalo primeropom_theme_upsert_custom_css— la alternativa reversible- Herramientas de ajustes