Documentación · Requisitos del sistema

Requisitos de hosting

Introducción

ADP Car Market Hub no impone exigencias inusuales a un proveedor de WordPress: cualquier proveedor que cumpla con los requisitos oficiales de WordPress y permita conexiones HTTPS salientes a la API de AutoScout24 puede ejecutarlo. Dicho esto, las importaciones de vehículos implican miles de llamadas a la API, descargas de imágenes, tareas programadas en segundo plano y una biblioteca de medios en constante crecimiento, por lo que el perfil de hosting práctico se asemeja más al de una tienda WooCommerce con mucho tráfico que al de un sitio web corporativo básico.

Este documento describe el hosting, los recursos del servidor, el acceso HTTPS saliente, el almacenamiento, las copias de seguridad, los entornos de staging y las consideraciones de preparación para producción para ADP Car Market Hub.

Cuándo utilizar este documento

Utilice este documento cuando:

Elija un plan de hosting para el sitio web de un nuevo concesionario.
Valide si un hosting existente puede manejar cómodamente la carga de trabajo de importación del plugin.
Planifique la capacidad de almacenamiento para las imágenes de los vehículos y los registros del plugin.
Configure un entorno de staging, una política de copias de seguridad o una lista de comprobación para la puesta en marcha en producción.

Descripción general

El perfil de hosting del plugin está determinado por las siguientes cargas de trabajo:

HTTPS saliente periódico hacia AutoScout24 (en cada ejecución de cron) y hacia el endpoint gestionado de Google Gemini cuando el AI Assistant está activado.
Descargas de imágenes desde los servidores de imágenes de AutoScout24 hacia wp-content/uploads/, con re-codificación opcional a WebP.
Picos de CPU y memoria PHP durante las tareas de Batch-Wizard, Full Sync y generación por IA.
Escrituras continuas de bajo volumen en la base de datos para eventos analíticos, leads, alertas de búsqueda y señales de vida (heartbeats) de cron.
Registros basados en archivos en wp-content/uploads/as24ci-logs/ (rotados a los 10 MB, con 7 días de retención).

Un hosting que pueda ejecutar cómodamente una tienda WooCommerce de tamaño mediano ejecutará este plugin sin problemas.

Requisitos

Servidor web

Software: Cualquier servidor web soportado oficialmente por WordPress; normalmente Nginx o Apache (LiteSpeed y Caddy también funcionan bien en la práctica).
HTTPS: Un certificado TLS válido en el sitio público. No se impone a nivel de plugin, pero la API de AutoScout24 y los navegadores modernos requieren HTTPS.
Procesador PHP: PHP-FPM (o equivalente) con PHP 8.1+ (consulte PHP and Database Requirements para más detalles).
Reescritura de URL: Motor de reescritura activo (mod_rewrite para Apache, try_files para Nginx) para que los enlaces permanentes amigables y la REST API funcionen.

Recursos del servidor

Estas son recomendaciones prácticas; el código del plugin no impone valores específicos más allá de los límites de PHP verificados por la pestaña System & Help.

CPU: Mínimo 1 vCPU para inventarios pequeños (< 100 vehículos); se recomiendan 2 vCPU o más para inventarios medianos o cuando la generación por IA está activada.
RAM: Mínimo 1 GB de memoria total del servidor; se recomiendan 2 GB o más. El memory_limit de PHP para el plugin debe ser de al menos 256 MB (la pestaña System & Help marca cualquier valor inferior a 128 MB como "demasiado bajo").
Tiempo de ejecución de PHP: Se recomienda un max_execution_time de 120 segundos o más para importaciones con muchas imágenes; la pestaña System & Help marca entre 30 y 60 segundos como simplemente "aceptable".
Concurrencia: Permita al menos 2 procesos de trabajo (workers) de PHP concurrentes para que una importación de larga duración no bloquee el sitio público o el panel de administración.

Acceso HTTPS saliente

El servidor debe poder realizar solicitudes HTTPS salientes (puerto 443) a:

https://api.autoscout24.com — obligatorio. Utilizado por el importador para tokens OAuth, listados y URL de imágenes.
Servidores CDN de imágenes de AutoScout24 — obligatorio. Las URL de las imágenes de los vehículos devueltas por la API se descargan directamente.
https://generativelanguage.googleapis.com — obligatorio cuando el AI Assistant está activado. Se utiliza para llamar al endpoint gestionado de Google Gemini configurado en AS24CI\Ai_Config.
https://api.wordpress.org — recomendado, para que las actualizaciones de WordPress y del plugin funcionen normalmente.

Si el hosting utiliza un cortafuegos de salida o un proxy, permita estos destinos y asegúrese de que los transportes HTTP estándar de WordPress (wp_remote_get / wp_remote_post, que utilizan cURL internamente) funcionen.

Almacenamiento

Espacio libre mínimo en disco: La pestaña System & Help marca < 100 MB libres como crítico y < 500 MB libres como advertencia. Considere 1 GB libre como el mínimo absoluto, incluso para inventarios pequeños.
Dimensionamiento práctico: Planifique aproximadamente entre 5 y 25 MB de almacenamiento de medios por vehículo, según la cantidad de imágenes y si la conversión a WebP está activada. Un concesionario con 200 vehículos suele utilizar entre 1 y 5 GB de subidas.
Permisos del sistema de archivos: El proceso PHP debe tener permisos de escritura en wp-content/uploads/. El plugin creará wp-content/uploads/as24ci-logs/ en el primer uso y lo protegerá con los archivos de seguridad estándar de WordPress.
Límites de inodos: Los hostings con cuotas estrictas de inodos deben tener en cuenta la gran cantidad de archivos pequeños (cada imagen de vehículo más sus tamaños intermedios generados por WordPress).

Correo electrónico

Se requiere una vía de correo electrónico transaccional que funcione para las características del usuario final:

Notificaciones de leads desde el formulario de contacto.
Notificaciones de reserva de pruebas de conducción.
Confirmaciones de doble opt-in para alertas de búsqueda (Smart Stock Alerts).
Correos electrónicos administrativos de WordPress (restablecimiento de contraseñas, notificaciones de errores).

Funciona tanto un MTA proporcionado por el hosting, un plugin SMTP que apunte a un proveedor de entregabilidad (Postmark, SendGrid, Brevo, Amazon SES, etc.) o un relé SMTP corporativo.

Copias de seguridad

El plugin no incluye un mecanismo de copia de seguridad; las copias de seguridad son responsabilidad del hosting. Una implementación en producción debería incluir:

Copias de seguridad diarias de la base de datos que cubran todas las tablas de WordPress, incluidas las tablas personalizadas del plugin ({prefix}as24_vehicles, la tabla de analítica, la tabla de alertas de búsqueda).
Copias de seguridad diarias del sistema de archivos de wp-content/uploads/ (imágenes de vehículos y registros del plugin) y wp-content/plugins/.
Retención externa (off-site) de al menos 7 días; más tiempo si las políticas locales de protección de datos lo requieren.
Pruebas de restauración al menos trimestralmente. Las eliminaciones de Full Sync son permanentes, por lo que las copias de seguridad probadas son la única vía de recuperación.

Entornos de staging y preparación para producción

Se recomienda encarecidamente disponer de un entorno de staging limpio antes del lanzamiento o de realizar actualizaciones:

Una instancia de WordPress independiente en las mismas versiones de PHP/MySQL que producción.
Credenciales de AutoScout24 distintas siempre que sea posible, o uso en modo de solo lectura para evitar alterar los datos de producción.
Tokens de cron distintos para cada entorno.
Un proceso de despliegue documentado (exportación/importación de base de datos, búsqueda y reemplazo de URL, reactivación del plugin para actualizar roles y reglas de reescritura).
Que la pestaña "System & Help" / Salud del plugin supere todas las comprobaciones en el entorno de staging antes de pasar los cambios a producción.

Configuración recomendada para producción

Hosting gestionado de WordPress en una rama reciente de PHP 8.x con PHP-FPM, Nginx o Apache, MySQL 8 / MariaDB 10.6+, y un contenedor o VM con más de 1 vCPU y 2 GB de RAM.
TLS 1.2+ en conexiones entrantes y una pila TLS saliente moderna con certificados CA actualizados.
memory_limit de PHP de 256 MB o más, max_execution_time de 300 s, upload_max_filesize de 64 MB o más.
Más de 10 GB de disco asignados a wp-content/uploads/ desde el primer día.
Cron a nivel de sistema operativo que active wp-cron.php (o el endpoint REST de cron del plugin) cada 5-15 minutos, con DISABLE_WP_CRON definido en wp-config.php.
SMTP a través de un proveedor transaccional con SPF/DKIM/DMARC correctamente alineados.
Copias de seguridad externas diarias de la base de datos y las subidas, retenidas durante al menos 30 días.
Entorno de staging idéntico, actualizado periódicamente desde producción.
Monitoreo de disponibilidad (uptime) en la URL del archivo público y en el endpoint del activador de cron.

Notas operativas

Las imágenes de los vehículos dominan el crecimiento del disco. Supervise el uso de las subidas a lo largo del tiempo y elimine los medios obsoletos (el plugin elimina automáticamente las imágenes de los coches borrados) o mueva las subidas a un almacenamiento de objetos mediante un plugin de descarga de medios (media-offload).
Los hostings con un reciclado agresivo de procesos de trabajo de PHP (por ejemplo, finalizar procesos después de 30 s) pueden interrumpir las importaciones grandes. Utilice el Batch-Wizard (lotes adaptativos pequeños) o la cola de imágenes (procesamiento asíncrono) en lugar de una única importación gigante.
Las CDN y los proxies inversos deben pasar el parámetro de consulta del token de cron sin modificar, y no deben almacenar en caché las respuestas de wp-admin/, wp-login.php, wp-cron.php o /wp-json/as24ci/v1/*.
El endpoint gestionado de Gemini puede tener una latencia alta por solicitud. Si activa la generación por IA durante las importaciones, aumente max_execution_time en consecuencia y priorice la cola de generación por IA asíncrona.
Los registros del plugin crecen de forma constante cuando el registro detallado (verbose) está activado. El plugin los rota a los 10 MB y elimina los archivos rotados con más de 7 días de antigüedad, pero el directorio aún debe incluirse en la supervisión regular del uso del disco.

Resolución de problemas

Importaciones lentas / tiempos de espera frecuentes: Aumente la memoria y el tiempo de ejecución de PHP, reduzca el tamaño del lote de vehículos por cron y asegúrese de que la cola de imágenes esté activada.
"Connection issue – could not fetch listings": Verifique la conexión HTTPS saliente a api.autoscout24.com, la resolución DNS desde el servidor y si un proxy corporativo o WAF está interceptando la solicitud.
Fallo al descargar imágenes: Verifique el espacio libre en disco, los permisos de la carpeta de subidas y que los servidores de imágenes de AutoScout24 sean accesibles.
Alertas de espacio en disco: Utilice la tarjeta de almacenamiento de la pestaña System & Help para confirmar la cifra de espacio libre y, a continuación, limpie los medios antiguos o amplíe el volumen.
Correos electrónicos no entregados: Configure un plugin SMTP o un MTA de hosting; muchos hostings compartidos bloquean la función directa mail() de PHP.
Las copias de seguridad no capturan todos los datos del plugin: Asegúrese de que la herramienta de copia de seguridad cubra toda la base de datos de WordPress (incluidas las tablas personalizadas con el prefijo {wp_prefix}as24_) y todo el directorio wp-content/uploads/.