Proceso de actualización

Este documento describe el proceso recomendado para actualizar el plugin ADP Car Market Hub en un sitio de producción de WordPress. Seguir un proceso de actualización estructurado reduce el riesgo de pérdida de datos, cambios de configuración o regresiones en el frontend.

Cuándo usar este documento

Lea este documento cada vez que haya una nueva versión del plugin disponible y necesite aplicarla a un sitio en vivo. Léalo también antes de cualquier actualización programada del núcleo de WordPress que pueda afectar a la compatibilidad del plugin.

Descripción general

Las actualizaciones del plugin pueden incluir correcciones de errores, parches de seguridad, nuevas características o cambios en el esquema de la base de datos. El plugin gestiona las migraciones del esquema de la base de datos automáticamente al activarse y en plugins_loaded, pero se recomienda encarecidamente realizar una prueba en un entorno de staging antes del despliegue en producción para cambios de versión significativos.

El proceso general es: revisar el registro de cambios → realizar una copia de seguridad → probar en staging → aplicar en producción → verificar el funcionamiento.

Requisitos

• Acceso de administrador al panel de administración de WordPress tanto en el entorno de staging como en el de producción.
• Una copia de seguridad completa reciente de la base de datos de producción y del directorio de subidas (consulte Copia de seguridad y restauración).
• Un entorno de staging que refleje el sitio de producción. Si no existe un entorno de staging, realice una copia de seguridad completa antes de actualizar y prepárese para revertir los cambios.
• La capacidad manage_as24_imports en la cuenta que realiza la actualización.

Instrucciones paso a paso

Paso 1: Revisar las notas de la versión

1. Lea las notas de la versión para la nueva versión (consulte Notas de la versión).
2. Identifique cualquier cambio importante, migración de base de datos o pasos de configuración enumerados en las notas de la versión.
3. Tome nota de cualquier nuevo requisito de versión de PHP o de WordPress. El plugin requiere PHP 8.1 o posterior y WordPress 6.2 o posterior a partir de la versión 1.0.0. Compruebe la cabecera del archivo del plugin o readme.txt para ver los requisitos declarados actuales.

Paso 2: Realizar una copia de seguridad completa

1. Realice una copia de seguridad de la base de datos de producción y del directorio wp-content/uploads/ antes de realizar cualquier cambio.
2. Anote la versión actual del plugin para poder revertir a ella si fuera necesario.
3. Guarde la copia de seguridad en una ubicación que sea accesible incluso si el panel de administración de WordPress deja de estar disponible (por ejemplo, una copia de seguridad a nivel de hosting o una descarga local).

Paso 3: Probar la actualización en staging

1. Aplique la nueva versión del plugin en el sitio de staging.
2. Si el sitio de staging no refleja el estado actual de producción, restaure una copia de seguridad de producción reciente en staging antes de aplicar la actualización.
3. Después de actualizar en staging, verifique lo siguiente: - Las páginas de administración del plugin se cargan sin errores de PHP ni pantallas en blanco. - La pestaña Salud no muestra nuevos problemas críticos. - El estado de la conexión de la API es Conectado en la pestaña Sistema y ayuda. - Una importación manual se completa con éxito (use el botón Activar importación ahora en Automatización). - Los listados de vehículos importados se muestran correctamente en el archivo del frontend y en las páginas de vehículos individuales. - El formulario de contacto de leads se envía correctamente y entrega un correo electrónico de notificación. - Los eventos de seguimiento de analítica se registran (si la analítica está activada).
4. Si se encuentra algún problema en staging, no proceda a producción. Reporte el problema y espere una solución o indicaciones.

Paso 4: Aplicar la actualización a producción

Opción A: Actualizar a través del administrador de WordPress

1. Inicie sesión en el administrador de WordPress de producción.
2. Vaya a Escritorio → Actualizaciones (o Plugins → Plugins instalados).
3. Localice ADP Car Market Hub en la lista de actualizaciones y haga clic en Actualizar.
4. WordPress desactivará el plugin, reemplazará los archivos del plugin y lo reactivará. El gancho de activación del plugin ejecuta las migraciones de esquemas y opciones automáticamente.

Opción B: Actualización manual de archivos

1. Ponga el sitio en modo de mantenimiento si su flujo de trabajo lo requiere.
2. Descargue el paquete de la nueva versión del plugin.
3. A través de SFTP o del gestor de archivos de su hosting, reemplace el contenido de wp-content/plugins/adp-car-market-hub/ con los archivos de la nueva versión.
4. El gancho plugins_loaded del plugin activará las migraciones de esquemas cuando se atienda la siguiente solicitud de WordPress.

Paso 5: Verificar la actualización en producción

1. Abra ADP Car Market Hub → Sistema y ayuda y confirme que el estado de la conexión de la API es Conectado.
2. Compruebe la pestaña Dashboard y confirme que los recuentos de vehículos y la información de la última ejecución están presentes.
3. Abra la pestaña Logs y confirme que no hay nuevos errores relacionados con la actualización.
4. Navegue a la página de archivo de vehículos en el frontend y confirme que los listados se cargan correctamente.
5. Si el número de versión del plugin se muestra en algún lugar de la administración (por ejemplo, en la pestaña Salud o Soporte), confirme que muestra la nueva versión.
6. Active una importación manual desde la pestaña Importación y límites y confirme que se completa sin errores.

Paso 6: Monitorear durante 24–48 horas

1. Después de la actualización en producción, realice las comprobaciones diarias estándar (consulte Flujos de trabajo de uso diario) durante los siguientes uno o dos días.
2. Esté atento a nuevos errores en la pestaña Logs.
3. Confirme que las importaciones programadas continúan ejecutándose a tiempo.

Referencia de configuración

Notas operativas

• El plugin utiliza los ganchos plugins_loaded y admin_init para comprobar y aplicar las migraciones del esquema de la base de datos. Las actualizaciones de esquema se ejecutan automáticamente y no requieren la ejecución manual de SQL.
• El plugin registra una capacidad personalizada (manage_as24_imports) durante la activación. Si falta esta capacidad después de una actualización, desactive y reactive el plugin para activar el registro de la capacidad.
• El plugin almacena una versión de la base de datos en la tabla de opciones de WordPress (as24ci_db_version). El plugin lee este valor y aplica cualquier migración pendiente cuando detecta una discrepancia de versión.
• Las anulaciones de plantillas personalizadas almacenadas fuera del directorio del plugin (por ejemplo, en un tema hijo) no se ven afectadas por las actualizaciones del plugin. Sin embargo, si la actualización cambia la estructura de las plantillas, es posible que deba actualizar sus plantillas personalizadas para que coincidan.
• La cola de imágenes, los transitorios de bloqueo de importación y el token de acceso almacenado en caché no se ven afectados por las actualizaciones del plugin. Las ejecuciones de importación en curso deberían completarse normalmente.

Revertir cambios

Si la actualización en producción causa problemas y se requiere revertir los cambios:

1. Restaure la copia de seguridad de la base de datos realizada en el Paso 2.
2. Restaure los archivos del plugin anteriores desde la copia de seguridad o descargando la versión anterior.
3. La versión anterior del plugin detectará el estado restaurado de la base de datos y los datos serán consistentes.
4. Investigue la causa del fallo antes de intentar la actualización de nuevo.

Resolución de problemas

Documentos relacionados

• Copia de seguridad y restauración
• Mantenimiento mensual
• Registro y monitoreo