Documentación · Operaciones y mantenimiento
Desinstalación y limpieza de datos
Este documento describe qué sucede cuando el plugin ADP Car Market Hub se desactiva o desinstala, qué datos se eliminan, cuáles se conservan y cómo controlar el comportamiento de la limpieza. También cubre los riesgos y las opciones de recuperación.
Cuándo utilizar este documento
Lea este documento antes de desinstalar el plugin de un sitio de producción. Es especialmente importante si desea conservar los datos de vehículos importados, los leads o las analíticas después de eliminar el plugin, o si necesita comprender qué se eliminará automáticamente.
Descripción general
La rutina de desinstalación del plugin se ejecuta cuando un administrador elimina el plugin a través de WordPress Admin → Plugins → Borrar. La rutina está definida en uninstall.php y se ejecuta en el contexto del administrador de WordPress.
El simple hecho de desactivar el plugin no elimina ningún dato. La eliminación de datos solo ocurre cuando el plugin se elimina (no solo se desactiva).
La rutina de desinstalación distingue entre:
- Elementos que siempre se eliminan, independientemente de cualquier ajuste.
- Elementos que se eliminan condicionalmente, solo si la opción Eliminar datos al desinstalar está activada.
- Elementos que nunca se eliminan mediante la rutina de desinstalación.
Qué se elimina siempre al desinstalar
Los siguientes elementos siempre se eliminan cuando se quita el plugin, independientemente del ajuste Eliminar datos al desinstalar:
| Elemento | Detalles |
|---|---|
| Todas las opciones del plugin | Todas las filas de wp_options con claves que tengan el prefijo as24ci_, incluidas las credenciales de la API, los ajustes de importación, la configuración de programación, los ajustes de diseño, los ajustes del formulario de leads y los ajustes de analíticas |
Tabla de la base de datos: {prefix}as24ci_analytics | Se elimina incondicionalmente porque contiene datos de seguimiento de visitantes y no debe persistir después de quitar el plugin |
Tabla de la base de datos: {prefix}as24_vehicles | Se elimina incondicionalmente (datos de campos de vehículos utilizados para visualización y búsqueda) |
Tabla de la base de datos: {prefix}as24ci_search_agents | Se elimina incondicionalmente porque contiene datos personales (nombre del suscriptor, correo electrónico, preferencias de búsqueda) |
Tabla de la base de datos: {prefix}as24ci_content_studio_jobs | Se elimina incondicionalmente (registros de tareas de generación de contenido por IA de Content Studio) |
Tabla de la base de datos: {prefix}as24ci_content_studio_assets | Se elimina incondicionalmente (recursos de marketing generados por Content Studio: subtítulos, hashtags, texto alternativo, referencias de imágenes) |
| Opciones de versión del esquema | as24ci_vehicles_db_version, as24ci_search_agent_db_version y as24ci_content_studio_db_version se eliminan junto con sus tablas |
| Eventos de WP-Cron | Se cancela la programación de as24ci_scheduled_import y as24ci_daily_cleanup |
| Transients | Se eliminan as24ci_access_token, as24ci_cron_import_running, as24ci_image_queue_running |
Estas eliminaciones no se pueden deshacer. Si necesita conservar los datos de analíticas o los datos de campos de los vehículos, expórtelos de la base de datos antes de desinstalar.
Qué se elimina condicionalmente al desinstalar
Los siguientes elementos solo se eliminan si la opción Eliminar datos al desinstalar (as24ci_delete_data_on_uninstall) está establecida en 1 (activada):
| Elemento | Detalles |
|---|---|
Entradas de vehículos (CPT: as24ci_car) | Todas las entradas del tipo de contenido personalizado as24ci_car, en cualquier estado (publicado, borrador, papelera), se eliminan de forma permanente |
| Imágenes de vehículos importadas | Los archivos adjuntos rastreados en el meta de entrada _as24ci_image_ids para cada entrada de vehículo se eliminan de forma permanente de la biblioteca de medios de WordPress |
| Imágenes destacadas | Si la imagen destacada de la entrada del vehículo es un archivo adjunto importado, también se elimina |
Entradas de leads (CPT: as24ci_lead) | Todas las entradas del tipo de contenido personalizado as24ci_lead se eliminan de forma permanente |
| Páginas creadas en la activación | La página de archivo, la página de comparación y la página de favoritos creadas por el plugin al activarse (IDs almacenados en as24ci_page_archive_id, as24ci_page_compare_id y as24ci_page_favorites_id) se eliminan de forma permanente |
Si esta opción está desactivada (por defecto), todas las entradas de vehículos, imágenes y leads permanecen en la base de datos y en la biblioteca de medios de WordPress después de eliminar el plugin. No se podrá acceder a ellos a través de la interfaz de administración del plugin, pero los datos subyacentes de WordPress se conservan.
Qué no se elimina nunca
Los siguientes elementos no se eliminan mediante la rutina de desinstalación, independientemente de los ajustes:
| Elemento | Detalles |
|---|---|
| Imágenes de galería subidas manualmente | Los archivos adjuntos rastreados en _as24ci_manual_image_ids (imágenes añadidas manualmente a través de la biblioteca de medios de WordPress, no importadas desde AutoScout24) nunca se eliminan |
| Cuentas de usuario de WordPress | Cualquier usuario al que se le haya concedido la capacidad manage_as24_imports conserva esa entrada de capacidad en el meta de usuario de WordPress |
| Archivos de registro (logs) | El directorio {uploads}/as24ci-logs/ y su contenido no se eliminan mediante la rutina de desinstalación. Elimínelos manualmente a través de SFTP o del gestor de archivos de su hosting si es necesario |
| Datos almacenados en la caché de objetos | Las cachés de objetos externas (como Redis o Memcached) pueden conservar datos temporales relacionados con el plugin hasta que expiren de forma natural |
Cómo controlar el comportamiento de la limpieza
La opción Eliminar datos al desinstalar se encuentra en la pestaña de ajustes del plugin.
- Abra ADP Car Market Hub → Ajustes.
- Busque el interruptor o casilla de verificación Eliminar datos al desinstalar.
- Actívelo si desea que todas las entradas de vehículos importados, imágenes, leads y páginas de activación se eliminen al borrar el plugin.
- Déjelo desactivado (por defecto) si desea conservar el contenido importado después de quitar el plugin.
Recomendación: Para un sitio de pruebas o desarrollo donde los datos importados se puedan descartar, active esta opción antes de desinstalar. Para un sitio de producción donde el historial de importación deba reutilizarse o auditarse, déjelo desactivado y gestione la eliminación del contenido de forma manual.
Comportamiento en Multisite
En instalaciones multisitio de WordPress, la rutina de desinstalación se ejecuta una vez por cada sitio de la red. Para cada sitio:
- Si Eliminar datos al desinstalar está activado, se eliminan las entradas de vehículos, imágenes, leads y páginas de activación de ese sitio.
- Las tablas personalizadas de la base de datos (
as24ci_analytics,as24_vehicles,as24ci_search_agents,as24ci_content_studio_jobs,as24ci_content_studio_assets) se eliminan para ese sitio (siempre). - Se eliminan todas las opciones del plugin para ese sitio (siempre).
- El bucle multisitio utiliza
switch_to_blog()/restore_current_blog()para procesar cada sitio de forma independiente.
Paso a paso: desinstalación segura en producción
- Realice una copia de seguridad completa de la base de datos y del directorio de subidas antes de continuar. Consulte Copia de seguridad y restauración.
- Si desea conservar los datos de los vehículos, deje desactivada la opción Eliminar datos al desinstalar (por defecto). Si desea una eliminación limpia, actívela ahora.
- Si necesita conservar los datos de analíticas para informes, exporte la tabla
{prefix}as24ci_analyticsde la base de datos utilizando phpMyAdmin, la CLI de WordPress o la herramienta de base de datos de su hosting antes de continuar. Esta tabla siempre se elimina al desinstalar. - Diríjase a WordPress Admin → Plugins.
- Primero desactive el plugin y luego haga clic en Borrar.
- Confirme el mensaje de eliminación. La rutina de desinstalación se ejecutará automáticamente.
- Verifique el resultado: - Diríjase a WordPress Admin → Herramientas → Base de datos (o una herramienta de base de datos) y confirme que las tablas personalizadas han desaparecido. - Si Eliminar datos al desinstalar estaba activado, verifique que la página de archivo de vehículos ya no existe. - Si se conservaron los datos, confirme que las entradas de los vehículos siguen presentes en WordPress Admin → Entradas o visitando directamente la URL del archivo.
- Elimine el directorio de registros manualmente a través de SFTP si ya no es necesario:
{wp-content/uploads}/as24ci-logs/.
Notas operativas y riesgos
- La tabla de analíticas (
{prefix}as24ci_analytics) siempre se elimina al desinstalar sin previo aviso, incluso si Eliminar datos al desinstalar está desactivado. Si tiene datos de analíticas que desea conservar, expórtelos antes de eliminar el plugin. - Del mismo modo, la tabla de vehículos (
{prefix}as24_vehicles), la tabla de agentes de búsqueda ({prefix}as24ci_search_agents) y las dos tablas de Content Studio ({prefix}as24ci_content_studio_jobs,{prefix}as24ci_content_studio_assets) siempre se eliminan. - Las imágenes importadas que se eliminan mediante la rutina de desinstalación se borran de forma permanente del sistema de archivos del servidor. No se pueden recuperar desde la biblioteca de medios de WordPress.
- Si la función
get_sites()no está disponible en una instalación multisitio, la rutina de desinstalación recurre al comportamiento de sitio único y procesa únicamente el sitio actual. - Las claves de opciones que se limpian al desinstalar se derivan de la clase
Optionsen tiempo de ejecución, por lo que la lista siempre está actualizada con la versión del plugin instalada. Se utiliza una lista predefinida alternativa si la claseOptionsno se puede cargar. - Desactivar el plugin sin eliminarlo no ejecuta la rutina de desinstalación. No se eliminan datos al desactivarlo. El plugin se puede volver a activar en cualquier momento y reanudará su funcionamiento normal.
Resolución de problemas
| Síntoma | Causa probable | Comprobación |
|---|---|---|
| Las entradas de vehículos siguen presentes después de desinstalar | Delete data on uninstall estaba desactivado (por defecto) | Comportamiento esperado; elimine las entradas manualmente o vuelva a activar la opción y elimine de nuevo |
| Faltan datos de analíticas después de desinstalar | La tabla de analíticas siempre se elimina al desinstalar | Exporte la tabla antes de eliminar el plugin |
| Los archivos de registro siguen presentes después de desinstalar | Los archivos de registro no se eliminan mediante la rutina de desinstalación | Elimine el directorio as24ci-logs/ manualmente a través de SFTP |
| Se han eliminado imágenes subidas manualmente | Compruebe que se añadieron a través de _as24ci_manual_image_ids, no importadas a través de _as24ci_image_ids | Si se eliminaron accidentalmente, restáurelas desde una copia de seguridad |
| Las opciones del plugin siguen presentes después de desinstalar | La rutina de desinstalación no se completó (error de PHP durante la eliminación) | Revise el registro de errores de PHP; vuelva a activarlo reinstalando y eliminando de nuevo |
| Las tablas personalizadas siguen presentes en la base de datos | La rutina de desinstalación encontró un error de permisos en la base de datos | Ejecute DROP TABLE IF EXISTS {prefix}as24ci_analytics manualmente |