Documentación · Empezando

Lista de comprobación para la puesta en marcha

Este documento es la lista de verificación de preparación para producción de ADP Car Market Hub. Reúne todos los elementos transversales que deben confirmarse antes de activar las importaciones automáticas en el sitio web de producción de WordPress de un cliente, de modo que el lanzamiento sea predecible y reversible.

Complementa en lugar de reemplazar a la Primera configuración: la Primera configuración describe cómo configurar el plugin paso a paso; este documento describe cómo verificar que la configuración es segura para pasar a la operación en vivo.

Cuándo usar este documento

Use este documento si es:

Una agencia o socio de implementación a punto de lanzar un nuevo despliegue de ADP Car Market Hub para un cliente.
Un administrador de WordPress que está promocionando una configuración de staging validada a un sitio de producción.
Un equipo de hosting responsable de confirmar que el entorno de producción está dimensionado y configurado para las importaciones programadas.
Un responsable de operaciones que ejecuta un relanzamiento controlado después de una migración de servidor, cambio de dominio, renovación de certificado o actualización importante del plugin.

El público objetivo es técnico: un administrador de WordPress con acceso completo al panel de administración, que trabaja en conjunto (cuando corresponda) con el proveedor de hosting y con quien posea el acceso a la API de AutoScout24 para el concesionario.

Descripción general

Un lanzamiento a producción para ADP Car Market Hub no es una única acción: habilitar las importaciones automáticas es el último paso de una cadena que depende de:

Preparación del entorno de hosting y PHP.
Credenciales de API correctas y propiedad del concesionario.
Una Prueba de conexión exitosa y repetible y al menos una importación de prueba exitosa.
Un frontend que haya sido revisado con datos reales de vehículos importados.
Ajustes legales, de privacidad y de consentimiento que coincidan con las políticas publicadas del concesionario.
Un plan de rollback documentado en caso de que algo falle después del lanzamiento.

La siguiente lista de verificación está agrupada por temas. Cada elemento debe marcarse como completado o aceptarse explícitamente con un motivo documentado antes de abrir el sitio al tráfico real con importaciones en vivo.

Requisitos antes de trabajar con la lista de verificación

Confirme que todo lo siguiente esté en su lugar antes de abrir esta lista de verificación:

El plugin está instalado y activado en el sitio de producción (consulte la Guía de instalación).
Existe un entorno de staging configurado y la misma configuración se ha replicado en producción (consulte Migración de Staging a Live).
Las credenciales de la API para la cuenta del concesionario están disponibles a través de un canal seguro (consulte Configuración de Credenciales de la API, Configuración de la API de AutoScout24, Credenciales de API externas).
El sitio cuenta con una copia de seguridad actual y restaurable que incluye la base de datos y wp-content/.
Las partes interesadas (concesionario, agencia, hosting) han acordado una ventana de tiempo de lanzamiento para monitorear las primeras importaciones.

Instrucciones paso a paso

Trabaje en las secciones en orden. No active la programación automática hasta que se haya confirmado cada elemento aplicable.

1. Entorno e infraestructura

[ ] WordPress cumple con la versión mínima del plugin (Requires at least: 6.2) y PHP cumple con el mínimo (Requires PHP: 8.1). Consulte Requisitos técnicos del sistema.
[ ] Las extensiones de PHP requeridas están presentes: openssl, curl, mbstring, json y una de gd o imagick. Consulte Requisitos de PHP y base de datos.
[ ] El firewall de hosting y cualquier WAF frente al sitio permiten HTTPS saliente hacia el host de la API AutoScout24 configurado. Consulte Requisitos de API, red y SSL.
[ ] El paquete CA del servidor confía en la cadena de certificados del host de la API (sin errores de validación SSL/TLS durante la Prueba de conexión).
[ ] El directorio wp-content/uploads/ tiene permisos de escritura para el usuario del servidor web, y wp-content/uploads/as24ci-logs/ está creado o se puede crear para el registro de logs del plugin.
[ ] Hay suficiente espacio en disco disponible para la biblioteca de medios proyectada (imágenes de vehículos importadas, incluyendo cualquier variante WebP si la conversión está habilitada).
[ ] Los recursos del servidor (memoria, tiempo máximo de ejecución, base de datos) están dimensionados para el catálogo previsto. Consulte Requisitos de hosting.
[ ] Se confirman todas las entradas de la Lista de verificación previa a la instalación.
[ ] Car Market Hub → System & Help no muestra insignias rojas.

2. Configuración del plugin

[ ] La licencia ha sido activada en Car Market Hub → Settings (tarjeta License Activation). Las pestañas de administración del plugin ya no muestran la pantalla "License required", lo que confirma que las áreas premium están desbloqueadas. Consulte Primera configuración.
[ ] Los ajustes principales del plugin en Car Market Hub → Settings se han guardado y reflejan el entorno de producción, no el de desarrollo (staging).
[ ] API Base URL, Seller ID (uno o más), Client ID y Client Secret están completados en Settings.
[ ] Default currency coincide con la moneda de precios del concesionario.
[ ] Las opciones de imagen (si se importan imágenes, el número máximo de imágenes por vehículo, la conversión opcional a WebP y la calidad) se han configurado deliberadamente y no se han dejado en los valores predeterminados sin verificar.
[ ] El estado predeterminado de la publicación y el autor predeterminado de la publicación para los vehículos recién importados son adecuados para producción.
[ ] La opción Default pages está habilitada (de modo que se crean las páginas Cars, Compare Cars y Favorites) o se gestiona explícitamente mediante las propias páginas del concesionario utilizando los shortcodes documentados.
[ ] Los filtros, mapeos, diseño y estilos, y cualquier personalización de plantilla se han revisado con datos reales de vehículos importados, no con contenido de prueba.

3. Conexión de la API

[ ] La Prueba de conexión de la API en Car Market Hub → Tools se completa con éxito en el sitio de producción, utilizando las credenciales de la API de producción. Consulte Prueba de conexión.
[ ] Si se configuran varios Seller ID, se ha ejecutado un Dry Run desde Tools y devuelve datos para cada Seller ID configurado.
[ ] No aparecen errores de autenticación, autorización o SSL en Car Market Hub → Logs para la Prueba de conexión y el Dry Run más recientes.
[ ] Las credenciales en producción no son los mismos valores provisionales utilizados durante las primeras pruebas de desarrollo; las credenciales de producción rotadas, cuando corresponda, se han vuelto a probar.

4. Importaciones de prueba y calidad de los datos

[ ] Al menos una importación manual de un solo vehículo a través de Car Market Hub → Car Importer se ha realizado con éxito, incluyendo los archivos adjuntos de imagen.
[ ] Se ha completado sin errores una importación manual completa a través del Batch-Wizard en Car Market Hub → Import & Limits. El Batch-Wizard permite pausar, reanudar y abortar si es necesario.
[ ] El número de vehículos importados coincide con lo previsto para los Seller ID configurados (verifique contra el inventario AutoScout24 del concesionario).
[ ] Se ha revisado una muestra representativa de los vehículos importados para verificar: título, precio, moneda, kilometraje, lista de equipamiento, recuento de imágenes y orden de las imágenes.
[ ] Full Sync solo se activa después de que la importación de prueba confirme que todos los vehículos previstos llegan correctamente. Full Sync elimina de forma permanente las publicaciones de vehículos locales y sus imágenes para cualquier anuncio que ya no devuelva la API.

5. Programación y procesamiento en segundo plano

[ ] Se ha elegido el intervalo de importación automática deseado (cada hora, cada 6 horas, dos veces al día, diariamente o personalizado) y refleja las expectativas de actualización de datos del concesionario.
[ ] Si WP-Cron no es fiable en el hosting (por ejemplo, porque las visitas a las páginas son demasiado escasas o el host limita el cron interno), se configura una tarea cron real del servidor contra el endpoint REST protegido por token del plugin. Consulte Configuración de Cron del servidor y Cron y procesamiento en segundo plano.
[ ] La cola de imágenes está habilitada para mantener las ejecuciones de cron dentro de los límites de tiempo de PHP en catálogos grandes. El estado de la cola en System & Help muestra un progreso saludable después de la importación de prueba.
[ ] Los ajustes de robustez de cron (número máximo de vehículos por ejecución de cron) están dimensionados para el catálogo y los límites de ejecución de PHP del host.
[ ] Se ha verificado el comportamiento de la caché de tokens: una nueva prueba tras la rotación de credenciales tiene éxito (vaciando la caché de tokens desde Tools si es necesario).

6. Frontend y experiencia del cliente

[ ] La página de archivo Cars se renderiza correctamente con vehículos reales, incluyendo filtros, paginación, ordenación y miniaturas de imágenes.
[ ] Se ha revisado de principio a fin al menos una página de vehículo individual: galería, tabla de detalles del vehículo, lista de equipamiento, formato de precio, formulario de contacto (con la casilla de verificación de consentimiento) y cualquier característica opcional (calculadora de financiación, formulario de prueba de conducción, compartir en redes sociales) que esté habilitada.
[ ] El envío de un formulario de contacto de prueba aparece en Car Market Hub → Leads y activa el correo electrónico del destinatario configurado.
[ ] Si las alertas de búsqueda están habilitadas, se ha completado una suscripción de prueba, incluyendo el correo electrónico de confirmación de doble opt-in. Consulte Doble Opt-In de alertas de búsqueda.
[ ] Si el AI Assistant está habilitado, se han revisado los resultados generados por IA en al menos un vehículo y son aceptables para su publicación.
[ ] Las traducciones / cadenas de idioma en el frontend reflejan el idioma del sitio; las cadenas que faltaban se han solucionado mediante el flujo de trabajo de traducción estándar de WordPress. Consulte Guía de traducción y PoEdit.

7. Aspectos legales, privacidad y consentimiento

[ ] El sitio tiene una política de privacidad publicada que cubre los datos que recopila el plugin (datos del formulario de contacto, eventos analíticos opcionales, suscripciones opcionales a alertas de búsqueda). Consulte Notas sobre RGPD / DSGVO y Descripción general del almacenamiento de datos.
[ ] La etiqueta de la casilla de verificación de consentimiento del formulario de contacto, su estado obligatorio y los campos visibles en Car Market Hub → Leads coinciden con la política de privacidad del concesionario. Consulte Datos de clientes potenciales y consentimiento.
[ ] Si la reserva de pruebas de conducción está habilitada, los días de la semana disponibles, la franja horaria diaria, la duración de las citas y las fechas excluidas reflejan la disponibilidad real del concesionario.
[ ] El concesionario ha aceptado que los datos importados de clientes potenciales y alertas de búsqueda se almacenarán en la base de datos de WordPress y es responsable de cualquier obligación de retención o exportación según la legislación aplicable.

8. Rendimiento, caché y SEO

[ ] Cualquier caché de página u objeto (caché del lado del servidor, CDN, plugin de caché) se ha configurado para que las páginas de archivo de vehículos y de vehículos individuales muestren datos actualizados después de cada importación, y para que las solicitudes de administración no se sirvan desde la caché.
[ ] Si una CDN sirve imágenes desde wp-content/uploads/, se han establecido purgas de imágenes o tiempos de vida de caché cortos para que las imágenes recién importadas sean visibles de inmediato.
[ ] El sitio es accesible en el dominio de producción final a través de HTTPS, y las opciones de WordPress Dirección del sitio / Dirección de WordPress apuntan a ese dominio.
[ ] El sitio no está configurado para "Disuadir a los motores de búsqueda de indexar este sitio" (a menos que esa sea la intención explícita del concesionario).
[ ] Existe un mapa del sitio XML (proporcionado por el núcleo de WordPress o por un plugin de SEO) y las nuevas URL de los vehículos siguen la estructura canónica del concesionario.
[ ] No quedan URL de desarrollo, direcciones de correo electrónico de prueba ni textos de consentimiento de prueba en la configuración de producción.

9. Operaciones, supervisión y soporte

[ ] Se ha abierto Car Market Hub → Logs y se comprende el comportamiento de rotación. El directorio de logs wp-content/uploads/as24ci-logs/ tiene permisos de escritura. Consulte Registro de logs y supervisión.
[ ] Se ha acordado con el cliente un calendario para las comprobaciones rutinarias: revisión diaria de clientes potenciales e importaciones (Operación diaria), Mantenimiento semanal y Mantenimiento mensual.
[ ] La Supervisión de importaciones y el Mantenimiento de la cola de imágenes son comprendidos por quien vaya a operar el sitio.
[ ] Se ha documentado y probado al menos una vez un procedimiento de copia de seguridad y restauración. Consulte Copia de seguridad y restauración.
[ ] Se ha acordado el canal de actualización del plugin (subida por el administrador de un nuevo archivo ZIP, o sustitución por SFTP de la carpeta del plugin) y coincide con el Proceso de actualización.
[ ] Existe un plan de rollback documentado: cómo desactivar la programación, cómo desactivar el plugin sin perder datos y cómo restaurar desde una copia de seguridad si es necesario.
[ ] Se ha delegado la operación diaria en los usuarios adecuados a través de los roles y capacidades del plugin. Consulte Control de acceso y capacidades.
[ ] Las vías de contacto para soporte están documentadas por parte del cliente: quién gestiona los problemas de WordPress, quién gestiona el hosting, quién es el propietario de la cuenta de la API de AutoScout24 y cómo escalar a AD Promotion si es necesario.
[ ] Se conoce de antemano la información necesaria para abrir un ticket de soporte. Consulte Lista de verificación de información de soporte.

10. Acciones finales para el lanzamiento

Solo después de haber marcado cada uno de los elementos aplicables anteriores:

Vuelva a ejecutar la Prueba de conexión en el sitio de producción como comprobación final de seguridad.
Active las importaciones automáticas en Car Market Hub → Import & Limits con el intervalo elegido.
Active una importación manualmente (o espere a la primera ejecución programada) y observe los Logs hasta que se complete.
Vuelva a comprobar el frontend en el dominio de producción, incluyendo el envío de un formulario de contacto real y, si corresponde, una suscripción real a las alertas de búsqueda.
Entregue el sitio a la rutina de supervisión acordada e informe al cliente de que las importaciones ya están activas.

Referencia de configuración

Este documento no introduce nuevos ajustes; solo hace referencia a la configuración documentada en otros lugares. Las páginas más relevantes son:

Campos de conexión de la API: consulte Configuración de Credenciales de la API.
Programación y límites de importación: consulte Primera configuración (Paso 5) y Cron y procesamiento en segundo plano.
Campos de clientes potenciales y consentimiento: consulte Datos de clientes potenciales y consentimiento.
Cron del servidor y activadores externos: consulte Configuración de Cron del servidor.

Notas operativas

Reversibilidad. Desactivar la programación automática en Import & Limits detiene las nuevas importaciones sin eliminar los vehículos ya importados. Desactivar el plugin deshabilita sus funciones pero mantiene los vehículos importados, las opciones, los leads y los datos analíticos en la base de datos. Los datos se eliminan al desinstalar solo cuando la configuración de limpieza correspondiente está activada. Consulte Uninstall and Data Cleanup.
Full Sync al lanzar. Por lo general, es más seguro lanzar con Full Sync desactivado, observar un ciclo de importación completo y activar Full Sync solo una vez que el inventario importado esté constantemente completo. Activar Full Sync de forma prematura puede eliminar permanentemente vehículos que simplemente faltaban en una respuesta transitoria de la API. Verifique este comportamiento en la versión actual del plugin antes de publicar si tiene dudas.
Cambios de dominio y URL. Si el sitio se va a lanzar en un nuevo dominio (por ejemplo, pasando de staging.example.com a www.example.com), asegúrese de que las URL de WordPress, cualquier capa de caché y cualquier servicio externo que enlace al sitio estén alineados antes de activar las importaciones. Consulte Staging to Live Migration.
Lanzamientos silenciosos. Para lanzamientos delicados, considere activar las importaciones automáticas fuera del horario comercial y observar el primer ciclo de cron a través de la vista Logs antes de que los clientes puedan acceder a las nuevas páginas.
Entrega de documentación. Proporcione al cliente las páginas relevantes del User Handbook y de la sección Operations and Maintenance, para que comprendan el flujo de trabajo diario del que se están haciendo cargo.

Resolución de problemas

Síntoma en el lanzamiento	Causa probable	Qué comprobar
La Prueba de conexión falla en producción pero pasó en staging.	Las credenciales de producción difieren, la red de producción es más restrictiva o el servidor de producción tiene un paquete de CA diferente.	Vuelva a introducir las credenciales, confirme el HTTPS saliente hacia el host de la API con el proveedor de hosting y revise los errores de SSL. Consulte Connection Test y API Connection Errors.
Las importaciones programadas no se inician tras activar la programación.	WP-Cron está desactivado o limitado en el host.	Configure una tarea cron del servidor contra el endpoint REST del plugin. Consulte Server Cron Setup y Cron Errors.
La primera importación en producción elimina vehículos que aún deberían existir.	Se activó Full Sync antes de confirmar que el inventario importado estaba completo.	Desactive Full Sync, restaure los vehículos afectados desde la copia de seguridad y vuelva a activar Full Sync solo después de observar un ciclo de importación completo y correcto.
Las páginas de vehículos se renderizan sin imágenes, o las imágenes aparecen gradualmente.	La cola de imágenes se está procesando en segundo plano (esperado) o los tiempos de espera de PHP interrumpen las descargas.	Observe el estado de la cola de imágenes en System & Help; active Run image queue now. Consulte Image Import Errors y Image Queue Maintenance.
Los correos electrónicos de leads no se entregan.	El sitio no puede enviar correos, la dirección del destinatario es incorrecta o el host bloquea el SMTP saliente.	Verifique el correo electrónico del destinatario en Leads y la configuración de correo saliente del sitio. Consulte Email and Lead Errors.
Las páginas en caché siguen mostrando el inventario de vehículos antiguo.	La caché de página o la CDN están sirviendo contenido obsoleto.	Configure la invalidación de caché o TTL más cortos para las URL afectadas.
Los visitantes aterrizan en URL de staging después del lanzamiento.	Enlaces obsoletos, URL del sitio WordPress incorrecta o DNS aún no propagado.	Confirme las opciones de WordPress Site Address y WordPress Address, y verifique la propagación de DNS para el dominio de producción.

Para diagnósticos más amplios basados en síntomas, consulte la sección Troubleshooting.