Documentación · Documentación técnica

Comportamiento de desinstalación y limpieza

Este documento explica exactamente qué sucede cuando el plugin ADP Car Market Hub se elimina de un sitio de WordPress, incluyendo qué datos se eliminan siempre, qué datos solo se eliminan cuando la opción de limpieza opcional está activada y cómo se gestionan las instalaciones multisitio.

Cuándo utilizar este documento

Lea este documento si necesita:

Planificar una eliminación limpia del plugin de un sitio de producción.
Entender si al eliminar el plugin se conservarán o destruirán los vehículos importados, los leads o los ajustes.
Auditar el cumplimiento del RGPD / protección de datos para la eliminación del plugin.
Migrar un sitio a otro plugin y necesita saber qué se queda atrás.

Descripción general

El plugin incluye un script uninstall.php que WordPress se ejecuta automáticamente cuando el plugin se elimina desde Plugins → Plugins instalados. El script:

Elimina siempre los transients del plugin y desprograma los eventos de WP-Cron del plugin.
Elimina siempre las tablas personalizadas de la base de datos del plugin, incluyendo aquellas que contienen datos personales o de visitantes.
Elimina opcionalmente las entradas creadas por el plugin (vehículos, leads, archivos adjuntos importados, páginas creadas por el plugin) cuando la opción Eliminar datos al desinstalar está activada.
Elimina siempre el conjunto completo de opciones del plugin.

La intención es priorizar la privacidad por defecto: cualquier dato que el plugin recopile sobre los visitantes (eventos de analítica, suscripciones a alertas de búsqueda) se elimina incondicionalmente, mientras que el contenido creado a partir de los datos importados (que un cliente puede querer conservar incluso después de desinstalar el importador) solo se elimina cuando el cliente opta por ello explícitamente.

Qué se elimina siempre

Independientemente del ajuste Eliminar datos al desinstalar, la rutina de desinstalación realiza lo siguiente:

Transients:
as24ci_access_token — token de acceso de AutoScout24 en caché.
as24ci_cron_import_running — bloqueo de ejecución de importación.
as24ci_image_queue_running — bloqueo del worker de la cola de imágenes.
Eventos de WP-Cron:
as24ci_scheduled_import — importación programada principal.
as24ci_daily_cleanup — limpieza de retención de analítica.
Tablas personalizadas:
<prefix>as24ci_analytics — eventos de seguimiento de visitantes.
<prefix>as24_vehicles — tabla de datos de campos de vehículos.
<prefix>as24ci_search_agents — suscripciones de búsquedas guardadas (contiene direcciones de correo electrónico y criterios de búsqueda).
<prefix>as24ci_content_studio_assets — recursos de Content Studio.
<prefix>as24ci_content_studio_jobs — tareas de Content Studio.
Opciones de versión de esquema:
as24ci_vehicles_db_version.
as24ci_search_agent_db_version.
as24ci_content_studio_db_version.
Opciones del plugin: cada clave declarada por AS24CI\Options::get_all_keys(), además de un pequeño conjunto de claves no constantes añadidas explícitamente: as24ci_models_cache_keys, as24ci_page_archive_id, as24ci_page_compare_id, as24ci_page_favorites_id, la heredada as24ci_api_total_cache y los ajustes de Content Studio (as24ci_content_studio_db_version, as24ci_content_studio_google_api_key, as24ci_content_studio_default_language, as24ci_content_studio_default_tone, as24ci_content_studio_brand_voice, as24ci_content_studio_disclaimer_text, as24ci_content_studio_compliance_notes).

Qué se elimina solo cuando la opción opcional está activada

El ajuste as24ci_delete_data_on_uninstall controla la limpieza destructiva del contenido creado por el plugin. Cuando es igual a 1, la rutina de desinstalación adicionalmente:

Itera todas las entradas as24ci_car (cualquier estado) y:
Elimina los archivos adjuntos listados en _as24ci_image_ids (imágenes importadas).
Elimina el archivo adjunto de la imagen destacada de la entrada cuando está presente.
Elimina la propia entrada del vehículo con wp_delete_post( $id, true ).
Elimina todas las entradas as24ci_lead.
Elimina las páginas creadas durante la activación cuyos IDs están almacenados en as24ci_page_archive_id, as24ci_page_compare_id y as24ci_page_favorites_id.

Los archivos adjuntos de galerías manuales (referenciados desde _as24ci_manual_image_ids) no se eliminan intencionadamente. Esto protege las imágenes que un cliente añadió a mano, incluso si la entrada del vehículo padre es eliminada.

Gestión multisitio

En una instalación de red:

El script itera cada sitio devuelto por get_sites().
Para cada sitio, realiza switch_to_blog(), ejecuta la limpieza destructiva (cuando se ha optado por ella), elimina las tablas de analítica, vehículos, alertas de búsqueda y Content Studio (tareas + recursos) de cada sitio, elimina las opciones de cada sitio y restore_current_blog().
Después de procesar cada sitio, la función finaliza y no ejecuta la rama de sitio único.

Verifique la ruta multisitio con la configuración de roles de su red antes de desinstalar de forma masiva en producción; el script no realiza ninguna acción en cascada entre sitios más allá de las operaciones enumeradas anteriormente.

Instrucciones paso a paso

Eliminar el plugin y conservar todo el contenido importado

(Opcional) Abra los ajustes del plugin y confirme que Eliminar datos al desinstalar está desactivado.
Vaya a Plugins → Plugins instalados, desactive "ADP Car Market Hub" y luego haga clic en Borrar.
Confirme la eliminación. WordPress ejecuta uninstall.php. Las entradas de vehículos importados y sus imágenes permanecen en la base de datos; los ajustes del plugin y los datos de los visitantes se eliminan.

Eliminar el plugin y todo el contenido creado por el plugin

Abra los ajustes del plugin.
Active Eliminar datos al desinstalar.
Guarde los cambios.
Vaya a Plugins → Plugins instalados, desactive el plugin, y luego haga clic en Borrar.
Confirme. WordPress ejecuta uninstall.php, lo que elimina los vehículos importados, los archivos adjuntos importados, los leads y las páginas de archivo/comparación/favoritos creadas por el plugin.

Referencia de configuración

Clave de opción	Efecto
`as24ci_delete_data_on_uninstall`	Cuando es `1`, también elimina las entradas importadas, los archivos adjuntos importados, las entradas de leads y las páginas creadas por el plugin al desinstalar. Por defecto `0`.

Para ver la lista completa de opciones del plugin, consulte Options And Settings Storage.

Notas operativas

La desinstalación se ejecuta en un contexto especial WordPress con un bootstrap limitado. El script evita cargar dependencias pesadas y es defensivo ante la falta de clases (se utiliza una lista de opciones codificada como alternativa si no se puede cargar AS24CI\Options).
Las eliminaciones de tablas personalizadas se realizan con DROP TABLE IF EXISTS sin procesar sobre el nombre de la tabla con prefijo. Los hostings que restringen los privilegios de modificación de esquemas pueden generar advertencias aquí; la eliminación se realiza como un intento de mejor esfuerzo y no aborta la desinstalación.
Las imágenes importadas que estén referenciadas por otras entradas (por ejemplo, reutilizadas como imágenes destacadas en contenido no relacionado) seguirán siendo eliminadas cuando la limpieza opcional esté activada. Audite la reutilización de archivos adjuntos importados antes de activar esta opción.
Las imágenes de galerías manuales permanecen en la biblioteca de medios de WordPress incluso cuando la limpieza opcional está activada; elimínelas por separado si es necesario.
Las URLs de webhooks y los secretos compartidos se almacenan en las opciones del plugin y, por lo tanto, se eliminan incondicionalmente al desinstalar. Los sistemas externos dejarán de recibir eventos tan pronto como se elimine el plugin.
La desactivación por sí sola (sin eliminación) no ejecuta uninstall.php. Solo borra los eventos pendientes de WP-Cron y actualiza las reglas de reescritura.

Resolución de problemas

Los vehículos importados permanecen después de la desinstalación — *Eliminar datos al desinstalar* estaba desactivado cuando se eliminó el plugin. Restaure el plugin temporalmente para acceder a la interfaz de administración, active la opción y luego vuelva a eliminarlo. Alternativamente, elimine las entradas as24ci_car manualmente con WP-CLI.
Las tablas personalizadas siguen existiendo después de la desinstalación — el usuario de la base de datos carece de privilegios DROP. Elimine las tablas manualmente con una cuenta con privilegios.
La desinstalación multisitio dejó algunos sitios con datos — confirme que el administrador de la red ejecutó la eliminación. Las desinstalaciones por sitio activadas por los administradores del sitio no siempre se propagan en cascada por toda la red dependiendo de la versión de WordPress. Verifique el comportamiento actual con su versión de WordPress antes de realizar despliegues grandes.
Las opciones del plugin vuelven a aparecer después de reinstalar — fueron recreadas por la activación. La limpieza solo se ejecuta al eliminar, no al desactivar.