Documentación · Requisitos del sistema

Requisitos técnicos del sistema

Introducción

ADP Car Market Hub es un plugin de WordPress que conecta un sitio de WordPress a la API de AutoScout24 y convierte el inventario de vehículos del concesionario en contenido nativo de WordPress (tipo de contenido personalizado as24ci_car con taxonomías de vehículos, páginas de archivo, plantillas de vehículo único, leads, analíticas y más).

Este documento ofrece una descripción general técnica de alto nivel de todo lo que el operador de un sitio necesita para planificar, instalar y ejecutar el plugin en producción. Consolida las expectativas de WordPress, hosting, PHP y base de datos que se documentan en detalle en las demás páginas de esta sección.

Cuándo utilizar este documento

Utilice este documento si está:

  • Evaluando si un entorno de hosting de WordPress existente puede ejecutar ADP Car Market Hub.
  • Especificando un nuevo entorno de hosting o una configuración de pruebas/producción para el sitio de un concesionario.
  • Realizando una comprobación técnica previa antes de instalar o activar el plugin.
  • Redactando una hoja interna de "requisitos del sistema" para un cliente o equipo de desarrollo.

Para obtener más detalles sobre cada tema, siga los enlaces de la sección Documentos relacionados.

Descripción general

A grandes rasgos, ADP Car Market Hub es un plugin de WordPress autónomo con las siguientes características arquitectónicas:

  • Distribución: Plugin estándar de WordPress, instalado en wp-content/plugins/ y activado desde el administrador de WordPress.
  • Cabeceras del plugin: Requires at least: 6.2, Requires PHP: 8.1 (definidas en el archivo principal del plugin y en readme.txt).
  • Espacio de nombres PHP: Todas las clases residen bajo el espacio de nombres AS24CI\ y se cargan automáticamente desde includes/ y includes/admin/.
  • Tipo de contenido personalizado: as24ci_car, con 15 taxonomías de vehículos (marca, tipo de carrocería, tipo de combustible, transmisión, etc.) para un filtrado nativo en WordPress.
  • Tablas de base de datos personalizadas: Creadas al activar el plugin mediante dbDelta() para vehículos, eventos analíticos y alertas de búsquedas guardadas. Se utilizan las tablas estándar de WordPress (wp_posts, wp_postmeta, wp_term_*, wp_options) para todo lo demás.
  • APIs externas: Llamadas HTTPS salientes a la API oficial de AutoScout24 (obligatorio) y al endpoint gestionado de Google Gemini (generativelanguage.googleapis.com) cuando el AI Assistant está habilitado.
  • Programación: Programador WP-Cron integrado con intervalos adicionales, además de un endpoint REST protegido por token (/as24ci/v1/cron-import) para activar importaciones desde un cron de servidor externo.
  • Procesamiento en segundo plano: Las importaciones se ejecutan por lotes, una cola de imágenes gestiona los archivos adjuntos de forma asíncrona y un bloqueo de importación (transitorio, TTL de 40 minutos) evita ejecuciones de cron superpuestas.
  • Biblioteca de medios: Las imágenes de los vehículos se importan como archivos adjuntos estándar de WordPress en wp-content/uploads/, con conversión opcional a WebP.
  • Registros: Los archivos de registro gestionados por el plugin se escriben en wp-content/uploads/as24ci-logs/ con rotación a los 10 MB y retención de 7 días.

El plugin incluye una pestaña interna de administración "Sistema y ayuda" / Salud que realiza las mismas comprobaciones de entorno descritas en este documento y muestra indicadores de tipo semáforo (verde/amarillo/rojo), lo cual es el punto de partida recomendado para cualquier validación en producción.

Requisitos

Los valores que se muestran a continuación reflejan lo que el plugin requiere realmente según sus cabeceras y código. En los casos en que el plugin solo comprueba "disponible / ausente" sin una versión específica, este documento sigue el mismo enfoque y enumera el requisito como una recomendación en lugar de un mínimo estricto.

Requisitos estrictos

  • WordPress: 6.2 o superior (Requires at least: 6.2 en la cabecera del plugin y readme.txt). Probado hasta WordPress 6.9.
  • PHP: 8.1 o superior (Requires PHP: 8.1 en la cabecera del plugin, readme.txt y composer.json).
  • Base de datos: Una base de datos compatible con WordPress (MySQL o MariaDB) en la versión admitida por su versión de WordPress. El plugin utiliza $wpdb, dbDelta() y consultas parametrizadas; no requiere una versión de base de datos específica propia.
  • Extensiones de PHP: openssl, curl, mbstring, json, y una de entre gd o imagick. La pestaña Sistema y ayuda marca el entorno como "Requisitos no cumplidos" si falta alguna de ellas.
  • HTTPS saliente: El servidor web debe poder realizar llamadas HTTPS salientes a https://api.autoscout24.com (y a https://generativelanguage.googleapis.com cuando el AI Assistant está habilitado).
  • Cron: Un mecanismo de programación que funcione, ya sea el WP-Cron integrado de WordPress o una tarea cron real a nivel de sistema operativo que active WP-Cron o el endpoint cron REST del plugin.
  • Sistema de archivos: Un directorio de subidas de WordPress con permisos de escritura (wp-content/uploads/) para las imágenes y para el directorio de registros del plugin (wp-content/uploads/as24ci-logs/).
  • Acceso de administrador: Un usuario de WordPress con manage_options para instalar y configurar el plugin; a continuación, el plugin proporciona una capacidad personalizada (manage_as24_imports) y un rol de "Editor de AS24" para la gestión diaria delegada.

Recomendado (no impuesto en el código)

  • PHP: Una rama de PHP 8.x con soporte activo (8.2 u 8.3) para obtener el mejor rendimiento a largo plazo y una postura de seguridad óptima.
  • memory_limit: ≥ 256 MB (la tarjeta de Salud marca entre 128 y 255 MB como "aceptable" y < 128 MB como "demasiado bajo").
  • max_execution_time: ≥ 120 s para importaciones con muchas imágenes (la tarjeta de Salud marca entre 30 y 60 s como aceptable, < 30 s como demasiado bajo, y 0 = ilimitado como ideal).
  • upload_max_filesize / post_max_size: Lo suficientemente grandes como para albergar cómodamente una sola imagen de vehículo en alta resolución (lo habitual es entre 8 y 16 MB).
  • ZipArchive: Disponible; se utiliza para los paquetes de exportación. No es estrictamente necesario para las importaciones.
  • ionCube Loader: La pestaña Sistema y ayuda detecta el ionCube Loader e informa de si está activo. Las versiones actuales del plugin no están codificadas, por lo que el cargador no es un requisito estricto hoy en día; se muestra para compatibilidad futura, ya que una versión codificada posterior podría requerirlo. Si su proveedor de hosting puede habilitar ionCube Loader para su versión de PHP, hacerlo evitará tener que realizar reconfiguraciones más adelante.
  • TLS: Una pila TLS moderna (TLS 1.2 o 1.3) en el lado de salida para que las llamadas HTTPS a AutoScout24 y al Gemini gestionado se realicen correctamente sin necesidad de soluciones temporales manuales con los certificados.
  • Enlaces permanentes amigables: Habilitados (cualquier configuración distinta de "Simple") para que las URL de archivo de vehículos y de vehículo único sean optimizadas para SEO.

Configuración de producción recomendada

Un despliegue de producción típico tiene el siguiente aspecto:

  • Pila tecnológica: Hosting gestionado de WordPress o un servidor LAMP/LEMP dedicado con PHP 8.1+ FPM, Nginx o Apache, y MySQL 8 / MariaDB 10.6+.
  • WordPress: Última versión estable de WordPress en la rama activa de soporte a largo plazo, con las actualizaciones automáticas en segundo plano habilitadas para versiones menores.
  • Límites de PHP: memory_limit = 256M (o superior), max_execution_time = 300, max_input_vars = 3000 para manejar cómodamente formularios de mapeo grandes.
  • Almacenamiento: Al menos varios GB de espacio libre en disco en wp-content/uploads/ para alojar las imágenes de los vehículos. Planifique aproximadamente entre 5 y 25 MB por vehículo, dependiendo del número de imágenes y del uso de WebP.
  • Cron: Desactive la ejecución de WP-Cron al cargar la página (define( 'DISABLE_WP_CRON', true );) y active wp-cron.php (o el endpoint cron REST) desde un cron real del sistema operativo cada 5-15 minutos para lograr importaciones predecibles.
  • Copias de seguridad: Copias de seguridad diarias externas de toda la base de datos de WordPress y del directorio wp-content/uploads/.
  • Entorno de pruebas (Staging): Un sitio de pruebas independiente (con sus propias credenciales de sandbox o de solo lectura de AutoScout24, siempre que sea posible) para probar las actualizaciones del plugin y los cambios en el mapeo de campos antes de pasarlos a producción.
  • Monitorización: Monitorización básica de disponibilidad (uptime) en la URL de archivo pública y en /wp-cron.php (o en el endpoint cron REST), además de alertas sobre el crecimiento del registro de errores de PHP.
  • Correo electrónico: Una ruta de correo transaccional fiable (plugin SMTP o MTA proporcionado por el hosting) para que se entreguen los leads de los formularios de contacto, las reservas de pruebas de conducción y los correos de doble opt-in para las alertas de búsqueda.

Notas operativas

  • La pestaña "Sistema y ayuda" del plugin en el administrador de WordPress reproduce cada comprobación de este documento con valores en tiempo real del sitio en funcionamiento. Utilícela después de cada cambio de WordPress, PHP o hosting.
  • Todas las importaciones son idempotentes: volver a ejecutar una importación nunca duplica un vehículo, ya que el plugin realiza la coincidencia basándose en los ID de AutoScout24 y utiliza hashes de contenido e imágenes para la detección de cambios.
  • La cola de imágenes limita intencionadamente el número de imágenes que se descargan por cada ciclo de cron para evitar tiempos de espera de PHP. En un sitio nuevo, las primeras ejecuciones de cron parecerán "incompletas" hasta que se vacíe la cola; este es el comportamiento esperado, no un error.
  • El modo Sincronización completa elimina de forma permanente los coches locales (y sus imágenes) que ya no existen en el listado remoto de AutoScout24. Asegúrese de tener copias de seguridad antes de habilitarlo en producción.
  • El plugin no elude el modelo de usuarios, capacidades o nonces de WordPress. Los plugins de seguridad reforzada, DISALLOW_FILE_EDIT y las configuraciones de proxy inverso son totalmente compatibles.
  • El plugin escribe sus propios registros y los rota al alcanzar los 10 MB. No requiere ni sustituye al registro de errores a nivel de servidor.

Resolución de problemas

  • Indicador "Requisitos no cumplidos" en la pestaña Sistema y ayuda: Compare la lista con los Requisitos anteriores y solucione el elemento que falte (normalmente una extensión de PHP ausente o una versión de PHP/WordPress demasiado baja).
  • Las importaciones agotan el tiempo de espera o se detienen a la mitad: Aumente max_execution_time y memory_limit, reduzca el tamaño del lote de vehículos por cron en la pestaña Importación y límites, y asegúrese de que la cola de imágenes esté habilitada.
  • Los vehículos se importan pero las imágenes no: Compruebe que se pueda escribir en wp-content/uploads/, que GD o Imagick estén instalados y que haya suficiente espacio libre en disco.
  • El cron no se ejecuta: Si el proveedor de hosting desactiva WP-Cron, configure un cron a nivel de sistema operativo para llamar a wp-cron.php o al endpoint REST protegido por token en su lugar.
  • La comprobación de conexión falla: La pestaña Sistema y ayuda y la pestaña Herramientas realizan una pequeña solicitud de listados de AutoScout24. Un fallo suele indicar credenciales de API incorrectas, la falta de un Seller ID o un cortafuegos que bloquea el HTTPS saliente hacia el host de AutoScout24.
  • Error 404 de enlace permanente en las páginas de vehículos: Vuelva a guardar la configuración de enlaces permanentes de WordPress para vaciar las reglas de reescritura después de activar el plugin.

Documentos relacionados