Documentación · Requisitos del sistema

Lista de comprobación previa a la instalación

Propósito

Esta lista de comprobación consolida todo lo que una agencia o administrador debe verificar antes de instalar ADP Car Market Hub o antes de pasar una instalación de pruebas (staging) a producción. Es intencionadamente práctica: cada elemento se corresponde con una comprobación concreta que se puede realizar en pocos minutos en el entorno de hosting, el sitio de WordPress o la cuenta de AutoScout24.

Cuándo utilizar este documento

Utilice este documento cuando:

Incorpore a un nuevo concesionario y necesite una única página para validar su hosting antes de instalar el plugin.
Promueva un sitio recién creado desde el entorno de pruebas (staging) a producción.
Audite una instalación existente que lleve un tiempo en funcionamiento y que pueda haberse desviado de la línea base recomendada.
Entregue un sitio a otra agencia o al equipo de TI interno del cliente.

Descripción general

La lista de comprobación se agrupa en nueve áreas. Cada área tiene un pequeño número de elementos de sí/no. Considere cualquier "no" como un elemento bloqueante para las importaciones de producción hasta que se resuelva o se exima explícitamente.

Para obtener un contexto más detallado sobre cualquier elemento, siga el enlace en la sección de Documentos relacionados en la parte inferior de esta página.

Lista de comprobación

1. Hosting y entorno de ejecución

[ ] PHP 8.1 o posterior está instalado y activo para el sitio de WordPress.
[ ] El valor de PHP memory_limit es de al menos 256 MB (128 MB es el mínimo absoluto que acepta la pestaña System & Help).
[ ] El valor de PHP max_execution_time es de al menos 120 segundos; se recomiendan 300 segundos para importaciones con gran volumen de imágenes.
[ ] Las extensiones de PHP openssl, curl, mbstring, json y una de gd / imagick están cargadas; ZipArchive está disponible para los paquetes de exportación.
[ ] Hay al menos 1 GB de espacio libre en disco disponible en el volumen que aloja wp-content/uploads/; planifique entre 5 y 25 MB por vehículo para archivos multimedia.
[ ] El servidor web ejecuta Nginx, Apache u otro servidor compatible con WordPress con la reescritura de URL habilitada.

2. WordPress

[ ] WordPress 6.2 o posterior está instalado.
[ ] HTTPS está activo en el sitio público con un certificado válido.
[ ] Los enlaces permanentes están configurados en cualquier opción que no sea "Simple" (necesario para el endpoint REST de cron y para URLs de archivo amigables).
[ ] Se dispone de una cuenta de administrador para la instalación y configuración.
[ ] No hay ningún plugin de AutoScout24 / importación de vehículos en conflicto activo.
[ ] Existe un entorno de pruebas (staging) con las mismas versiones de PHP/MySQL que el de producción.

3. Base de datos

[ ] Se utiliza MySQL 5.7+ o MariaDB 10.3+ (coincidiendo con los mínimos del propio WordPress), con utf8mb4 como juego de caracteres predeterminado.
[ ] El usuario de la base de datos de WordPress tiene los privilegios CREATE, ALTER, INDEX, DROP, INSERT, UPDATE, DELETE y SELECT para que la activación pueda ejecutar dbDelta() para las tablas personalizadas del plugin.
[ ] Las copias de seguridad diarias de la base de datos están configuradas y se ha probado su restauración al menos una vez.

4. Red, API y SSL

[ ] Se permiten las conexiones HTTPS salientes (TCP/443) desde el servidor web hacia el host de la API de AutoScout24 configurado (por ejemplo, api.autoscout24.com, api.autoscout24.ch, …) y hacia los hosts de la CDN de imágenes de AutoScout24.
[ ] La resolución DNS desde el propio servidor web funciona para los nombres de host de AutoScout24.
[ ] El paquete de CA del sistema está actualizado; la interceptación de TLS saliente (si la hay) instala su CA raíz corporativa en el almacén de confianza del sistema.
[ ] Si se requiere un proxy HTTP saliente, las constantes WP_PROXY_* están definidas en wp-config.php.
[ ] Si se va a utilizar la generación por IA, se permite la conexión HTTPS saliente hacia generativelanguage.googleapis.com. Las funciones de IA utilizan la configuración gestionada de Google Gemini en ADP Car Market Hub; no es necesario introducir ningún proveedor, modelo o clave de API en el backend de WordPress; el aprovisionamiento de IA específico para el cliente lo completa AD Promotion tras la instalación.

5. Licencia y cuenta de AutoScout24

[ ] Se dispone de la clave de licencia de ADP Car Market Hub proporcionada por AD Promotion. La licencia es necesaria para desbloquear las áreas premium del plugin tras la activación; sin ella, todas las pestañas de administración excepto Settings mostrarán una pantalla de "Licencia requerida".
[ ] Se dispone de una cuenta de socio activa de AutoScout24 con acceso a la API.
[ ] El Client ID y el Client Secret se han emitido y guardado de forma segura (gestor de contraseñas o bóveda de secretos).
[ ] Se conocen uno o más Seller IDs y se ha confirmado que pertenecen al concesionario o concesionarios que se están incorporando.
[ ] Se conoce la URL base de la API correcta para el mercado del distribuidor (por ejemplo, https://api.autoscout24.ch para Suiza).
[ ] Las IPs de salida del servidor de producción se han compartido con AutoScout24 si la cuenta requiere una lista de IPs permitidas.

6. Cron y procesamiento en segundo plano

[ ] Se ha elegido una estrategia de cron: WP-Cron (aceptable solo para sitios pequeños o con mucho tráfico) o cron del servidor (recomendado para producción).
[ ] Si se elige el cron del servidor, se ha añadido define( 'DISABLE_WP_CRON', true ); a wp-config.php.
[ ] Si se elige el cron del servidor, se planifican dos entradas de cron: una que llama al endpoint REST del plugin con el token secreto (cada 15 minutos es un buen valor predeterminado) y otra que ejecuta wp-cron.php (cada 5 minutos) para mantener activos la cola de imágenes, la limpieza de analíticas y otras tareas recurrentes.
[ ] El token secreto de cron se almacenará junto con las credenciales y se rotará cada vez que el personal con acceso deje el proyecto.
[ ] Se planifican tokens de cron distintos para el entorno de pruebas (staging) y para producción, de modo que un activador de pruebas no pueda iniciar una importación de producción.

7. Correo electrónico

[ ] Se ha configurado una ruta de correo electrónico transaccional que funcione (MTA de hosting, plugin SMTP que apunte a un proveedor de entregabilidad o relé corporativo).
[ ] Se ha verificado la alineación de SPF, DKIM y DMARC para el dominio de envío.
[ ] Se han enviado y recibido correos electrónicos de prueba (notificación de clientes potenciales, suscripción a alertas de búsqueda, restablecimiento de contraseña de WordPress).

8. Copias de seguridad, monitorización y operaciones

[ ] Las copias de seguridad externas diarias cubren toda la base de datos de WordPress (incluidas las tablas personalizadas del plugin con el prefijo {wp_prefix}as24_) y todo el directorio wp-content/uploads/, con al menos 7 días de retención (se recomiendan más de 30 días).
[ ] Se ha ensayado la restauración de copias de seguridad al menos una vez.
[ ] La monitorización de tiempo de actividad (uptime) está configurada en la URL del archivo público.
[ ] La monitorización de tiempo de actividad o de éxito está configurada en el endpoint del activador de cron cuando se utiliza el cron del servidor.
[ ] Se han configurado alertas de espacio en disco para el volumen que aloja wp-content/uploads/.
[ ] Existe un contacto de guardia y una ruta de escalada documentada para incidentes en producción.

9. Validación previa al lanzamiento en WordPress

[ ] Plugin instalado y activado en el entorno de pruebas (staging).
[ ] Licencia activada en Settings → License Activation para desbloquear las demás pestañas de administración (sin pantalla de "Licencia requerida").
[ ] Configuración completada: URL base de la API, URL del token (si es necesaria), Client ID, Client Secret, Seller ID(s).
[ ] La pestaña Tools → Test Connection devuelve un resultado correcto.
[ ] La pestaña System & Help / Health muestra indicadores verdes para PHP, base de datos, espacio en disco, cron, API y (si está configurado) el AI Assistant.
[ ] Una pequeña importación con el Batch-Wizard ha generado las publicaciones de vehículos, taxonomías y archivos multimedia esperados.
[ ] Las páginas de vehículos individuales y el archivo se renderizan correctamente con el tema activo.
[ ] Se ha enviado un cliente potencial de prueba y una suscripción de prueba a las alertas de búsqueda, y se han recibido los correos electrónicos correspondientes.
[ ] El modo de cron, la programación, el límite de vehículos por ejecución y la cola de imágenes se han finalizado en la pestaña Import & Limits.
[ ] Se ha ejecutado una importación de extremo a extremo a través del activador equivalente al de producción (cron del servidor o alternativa elegida).
[ ] Se ha vuelto a validar la misma lista de comprobación en producción tras la puesta en marcha.

Aprobación

Antes de habilitar las importaciones de producción, confirme que cada elemento anterior esté marcado o aceptado formalmente como una limitación conocida, y registre:

Quién realizó las comprobaciones y en qué fecha.
La versión del plugin instalada (consulte la página de plugins de WordPress).
Las versiones de PHP, WordPress y de la base de datos en uso.
El modo de cron y la programación configurados.
El propietario de las credenciales de AutoScout24 y del token secreto de cron.

Un breve archivo de texto o una página de wiki con lo anterior es suficiente y simplifica enormemente las solicitudes de soporte posteriores.