Documentación · Operaciones y mantenimiento

Copia de seguridad y restauración

Este documento explica qué datos crea o gestiona el plugin ADP Car Market Hub, qué componentes deben incluirse en una copia de seguridad y cómo restaurar un sitio a un estado operativo después de un fallo o migración.

Cuándo usar este documento

Lea este documento si es administrador del sitio, ingeniero de hosting o desarrollador de WordPress responsable de la estrategia de copias de seguridad y recuperación ante desastres en un sitio que ejecuta el plugin. Revíselo antes de realizar una actualización del plugin, una migración de servidor o cualquier cambio significativo de configuración.

Descripción general

El plugin almacena datos en varias ubicaciones dentro de la instalación de WordPress. Una copia de seguridad completa y restaurable debe incluir todos estos componentes. El plugin en sí no proporciona sus propias herramientas de copia de seguridad; las copias de seguridad dependen del enfoque estándar de copia de seguridad de WordPress utilizado por su proveedor de hosting o plugin de copia de seguridad.

Los listados de vehículos importados se pueden volver a importar desde AutoScout24 si se pierden, pero solo si hay una conexión API válida disponible. La configuración del plugin, los leads, los datos de analítica y los archivos de registro no se pueden recuperar desde AutoScout24 y deben protegerse mediante la copia de seguridad del sitio.

Qué almacena el plugin

Tipo de datos	Ubicación de almacenamiento	Notas
Ajustes y configuración del plugin	Tabla de opciones de WordPress (`wp_options`)	Todas las claves de opción tienen el prefijo `as24ci_`
Entradas de anclaje de vehículos	Tabla de entradas de WordPress (`wp_posts`, `wp_postmeta`)	Tipo de entrada personalizado (Custom Post Type): `as24ci_car`. La entrada actúa como el anclaje de WordPress (enlace permanente, taxonomías, plantilla) y almacena un pequeño conjunto de metadatos de entrada exclusivos del importador (por ejemplo, `_as24ci_listing_id`, `_as24ci_content_hash`, `_as24ci_image_ids`). La mayor parte de los datos de los campos del vehículo reside en la tabla personalizada que se detalla a continuación.
Datos de los campos del vehículo	Tabla de base de datos personalizada `{prefix}as24_vehicles`	Una fila por vehículo, vinculada a la entrada de `as24ci_car` por `post_id`. Contiene los atributos estructurados del vehículo utilizados para la visualización, los filtros de archivo y la búsqueda.
Leads (envíos de formularios de contacto)	Tabla de entradas de WordPress (`wp_posts`, `wp_postmeta`)	Tipo de entrada personalizado (Custom Post Type): `as24ci_lead`
Eventos de analítica	Tabla de base de datos personalizada `{prefix}as24ci_analytics`	Seguimiento de eventos de visitantes; se elimina al desinstalar el plugin
Agentes de búsqueda (alertas de stock para visitantes)	Tabla de base de datos personalizada `{prefix}as24ci_search_agents`	Datos personales; se elimina al desinstalar el plugin
Tareas de Content Studio y recursos generados	Tablas de base de datos personalizadas `{prefix}as24ci_content_studio_jobs` y `{prefix}as24ci_content_studio_assets`	Tareas de generación de contenido por IA y sus resultados de marketing generados (subtítulos, hashtags, texto alternativo, referencias de imágenes); ambas se eliminan al desinstalar el plugin
Imágenes de vehículos importadas	Biblioteca de medios de WordPress (`wp_uploads/`)	Adjuntas a las entradas de vehículos; rastreadas en `_as24ci_image_ids`
Archivos de registro del plugin	`{wp-uploads}/as24ci-logs/adp-car-market-hub.log`	Rotados a los 10 MB; los archivos históricos se purgan después de 7 días
Páginas creadas por el plugin	Páginas de WordPress en `wp_posts`	Página de archivo, página de comparación y página de favoritos; IDs almacenados en las opciones `as24ci_page_archive_id`, `as24ci_page_compare_id` y `as24ci_page_favorites_id`

Requisitos

Una solución de copia de seguridad de WordPress capaz de respaldar tanto la base de datos como el sistema de archivos (carpeta de subidas). Los ejemplos incluyen instantáneas (snapshots) a nivel de hosting, servicios de copia de seguridad gestionados o plugins de copia de seguridad de WordPress. Verifique este comportamiento y la compatibilidad con su entorno actual.
Acceso de escritura al entorno de pruebas (staging) o de recuperación para realizar pruebas de restauración.
La misma versión de PHP y la misma versión de WordPress que en producción al restaurar en un entorno de pruebas, para evitar problemas de compatibilidad.

Procedimiento de copia de seguridad

Copia de seguridad de la base de datos

Realice una copia de seguridad de toda la base de datos de WordPress. Esto captura wp_options (ajustes del plugin), wp_posts y wp_postmeta (entradas de anclaje de vehículos y leads), y todas las tablas personalizadas gestionadas por el plugin ({prefix}as24_vehicles, {prefix}as24ci_analytics, {prefix}as24ci_search_agents, {prefix}as24ci_content_studio_jobs, {prefix}as24ci_content_studio_assets).
Utilice una herramienta de copia de seguridad o una instantánea de hosting que exporte un volcado SQL completo. Las copias de seguridad parciales que solo incluyen tablas seleccionadas pueden omitir las tablas personalizadas.
En instalaciones multisitio de WordPress, cada sitio de la red tiene su propio conjunto de tablas {prefix}_{siteid}_. Confirme que su herramienta de copia de seguridad capture todas las tablas del sitio.

Copia de seguridad de archivos

Realice una copia de seguridad del directorio wp-content/uploads/ de WordPress. Este contiene: - Todas las imágenes de vehículos importadas (adjuntas a las entradas de vehículos). - El directorio de registros del plugin: as24ci-logs/. Este directorio está protegido del acceso público mediante un archivo .htaccess; confirme que su herramienta de copia de seguridad capture los archivos ocultos.
Realice una copia de seguridad del directorio del plugin wp-content/plugins/adp-car-market-hub/ si ha realizado cambios personalizados a nivel de archivo (por ejemplo, sobreescrituras de plantillas personalizadas). Tenga en cuenta que el directorio del plugin en sí normalmente se reemplaza durante las actualizaciones y no debe ser el lugar principal para las personalizaciones.

Nota de configuración

Las credenciales de la API del plugin (Client ID, Client Secret) se almacenan en las opciones de WordPress y se incluyen en la copia de seguridad de la base de datos. Estos son valores sensibles. Asegúrese de que los archivos de copia de seguridad de la base de datos se almacenen de forma segura y que el acceso esté restringido.

Procedimiento de restauración

Restauración completa del sitio

Restaure la base de datos desde la copia de seguridad utilizando el panel de control de su hosting, phpMyAdmin o un cliente MySQL de línea de comandos.
Restaure el directorio wp-content/uploads/ desde la copia de seguridad de archivos.
Si va a restaurar en un nuevo servidor o dominio, actualice la URL del sitio de WordPress en la base de datos (filas wp_options, siteurl y home) utilizando la CLI de WordPress (wp option update) o editando la base de datos directamente.
Limpie cualquier caché de objetos de WordPress después de la restauración.
Inicie sesión en la administración de WordPress y navegue a ADP Car Market Hub → System & Help para verificar el estado de la conexión de la API.
Abra ADP Car Market Hub → Import & Limits y confirme que la programación de la importación esté activa.
Active una importación manual desde la pestaña Import & Limits y verifique que los vehículos se creen o actualicen correctamente.

Restauración parcial: solo ajustes

Si solo es necesario restaurar los ajustes del plugin (por ejemplo, después de una mala configuración accidental):

Importe la copia de seguridad de la base de datos en una base de datos temporal o de pruebas (staging).
Extraiga las filas wp_options pertinentes con claves que tengan el prefijo as24ci_ utilizando una consulta SQL o una herramienta de comparación de bases de datos.
Aplique los valores de opción recuperados a la base de datos de producción.
Pruebe la conexión y el flujo de importación antes de confirmar que la restauración se ha completado.

Restaurar solo imágenes de vehículos

Si las imágenes de los vehículos se han eliminado accidentalmente de la biblioteca de medios:

Restaure la copia de seguridad de archivos de wp-content/uploads/ para recuperar los archivos de imagen originales.
Alternativamente, vuelva a ejecutar la importación con la importación de imágenes habilitada. El importador comprueba las URLs de origen de los archivos adjuntos existentes (metadatos de entrada _as24ci_source_url) y omite las imágenes que ya están presentes. Las imágenes que falten se volverán a descargar desde AutoScout24.

Notas operativas

El plugin no puede gestionar ni programar copias de seguridad de forma independiente. La responsabilidad de la copia de seguridad recae en el propietario del sitio, el proveedor de hosting o un plugin de copia de seguridad dedicado de WordPress.
La tabla de analítica ({prefix}as24ci_analytics) y la tabla de agentes de búsqueda ({prefix}as24ci_search_agents) contienen datos personales (eventos de visitantes, direcciones de correo electrónico de suscriptores). Manipule los archivos de copia de seguridad que contengan estas tablas de acuerdo con las normativas de privacidad aplicables.
El proceso de desinstalación del plugin siempre elimina la tabla de analítica, incluso si la opción Delete data on uninstall está desactivada. Si tiene la intención de conservar los datos de analítica durante una reinstalación del plugin, exporte o conserve la tabla manualmente antes de desinstalar.
Las imágenes de vehículos importadas por el plugin se rastrean en los metadatos de la entrada bajo _as24ci_image_ids. Estos IDs vinculan las entradas de vehículos con sus archivos adjuntos en la biblioteca de medios. Si estos metadatos de entrada no están presentes en una restauración, las imágenes pueden permanecer en la biblioteca de medios como archivos adjuntos huérfanos.
Los archivos de registro en as24ci-logs/ no son críticos para restaurar la funcionalidad del sitio, pero pueden contener información de diagnóstico útil. Si necesita conservar más de 7 días de historial de registro, copie los archivos de registro archivados a un almacenamiento a largo plazo antes de que el plugin los purgue.

Resolución de problemas

Síntoma	Causa probable	Comprobación
La conexión de la API falla después de la restauración	La URL del sitio o las credenciales han cambiado	Verifique las credenciales en la pestaña Settings; compruebe la URL del sitio en wp_options
Las imágenes de los vehículos no se muestran después de la restauración	Los archivos de subidas no se han restaurado, o los IDs de los archivos adjuntos de la biblioteca de medios están desincronizados	Restaure el directorio de subidas; active una reimportación para volver a descargar las imágenes
La programación de la importación no se ejecuta después de la restauración	Los eventos de WP-Cron no se han migrado	Vuelva a habilitar la importación automática en la pestaña Import & Limits para reprogramar el evento cron
Las tablas personalizadas no están presentes después de la restauración	La copia de seguridad no incluyó las tablas personalizadas	Active y desactive el plugin para forzar la creación de tablas, o restaure la base de datos desde una copia de seguridad completa
Las notificaciones de leads no se entregan después de la restauración	El ajuste del correo electrónico del destinatario ha cambiado o la configuración de correo de WordPress es diferente en el nuevo servidor	Verifique el correo electrónico del destinatario de leads en Settings; compruebe la entrega de correo de WordPress