pom_theme_delete_html_template: eliminar una plantilla HTML

Elimina una plantilla. Marcada como destructiva; no hay papelera ni historial de revisiones.

Argumentos

Permisos

Permitir escrituras en POM Theme abiertas, más manage_options.

Comprueba primero las asignaciones

Este es el paso que separa una limpieza de una caída del sitio. Una plantilla que renderiza un archivo o un tipo de contenido en vivo es una de la que dependen las páginas, y nada en esta herramienta te lo advierte.

Lee las asignaciones de la plantilla y dime si esta plantilla está en uso en algún sitio.

Eliminar una plantilla asignada deja la asignación apuntando a la nada. Las páginas afectadas recurren a lo que el tema hace con una plantilla ausente, un estado que no quieres descubrir por medio de un visitante.

Reasigna primero, elimina después.

Nada limpia la asignación

Eliminar la plantilla no borra el ajuste que apuntaba a ella. La referencia obsoleta permanece hasta que alguien la sobrescribe con pom_theme_assign_template.

De modo que, tras eliminar una plantilla asignada, el sitio tiene una asignación que nombra una plantilla que ya no existe, y volver a leer las asignaciones mostrará ese identificador como si fuera válido.

Un identificador incorrecto da éxito

Al igual que en la eliminación del fragmento de CSS, esto filtra la lista y devuelve deleted como si el recuento cambió.

Un identificador que no coincide con nada devuelve deleted: false, no un error. Y como la búsqueda se limita a template_type, un identificador correcto bajo el tipo equivocado produce exactamente el mismo «no resultado» silencioso.

Lee el valor. Una llamada que «tuvo éxito» puede no haber hecho nada.

La simulación cuenta y detecta la discrepancia de tipo

Devuelve before_count y after_count para ese tipo de plantilla. Recuentos iguales significan que el identificador no coincidió con nada en ese tipo, que es el caso que merece detectarse.

No te dice qué plantilla, ni su marcado, ni si está asignada. Confirma todo eso a partir del listado y de las asignaciones.

Lee y conserva el marcado

Las plantillas no tienen revisiones. La salida de pom_theme_get_html_template es la única copia.

Muéstrame el marcado completo de esa plantilla. Quiero conservarlo antes de que la elimines.

Guárdalo fuera de la conversación. Una plantilla representa trabajo de diseño real, y reescribir una de memoria no es lo mismo que restaurarla.

Desasignar es la alternativa reversible

Si el objetivo es dejar de renderizar una plantilla, apunta el destino a una plantilla diferente o a un diseño integrado. La plantilla permanece, y volver atrás es una sola llamada.

Elimina solo plantillas que sean realmente obsoletas, y confirma primero que están desasignadas; en ese caso, eliminarlas no cambia nada visible en absoluto.

Los recursos adjuntos sobreviven

Los fragmentos de CSS y los scripts a los que hacía referencia una plantilla no se eliminan con ella. Permanecen, sin referencias, y siguen en la hoja de estilos compilada.

Eso es seguro pero desordenado: eliminar varias plantillas con el tiempo deja fragmentos huérfanos. Audítalos por separado con pom_theme_get_custom_css.

Después de eliminar

1. Comprueba que deleted es verdadero.
2. Lista las plantillas de ese tipo y confirma que se eliminó la correcta.
3. Lee las asignaciones y confirma que nada apunta al identificador eliminado.
4. Carga los tipos de página afectados.
5. Purga la caché.

Problemas comunes

Relacionado

• pom_theme_get_template_assignments — comprueba antes de eliminar
• pom_theme_get_html_template — conserva una copia
• pom_theme_assign_template — reasigna en su lugar