Documentación · Notas de la versión

Limitaciones conocidas

Este documento resume las limitaciones conocidas del plugin ADP Car Market Hub en la versión actual.

Cuándo utilizar este documento

Lea este documento cuando planifique un despliegue, cuando prepare una nota de riesgos para el cliente o cuando solucione problemas de comportamiento que puedan ser una limitación documentada en lugar de un error.

El análisis técnico detallado se encuentra en Known Limitations And Open Risks. Esta página es un resumen más breve destinado a los lectores de las notas de la versión.

Descripción general

El plugin se basa en los mecanismos estándar de WordPress (custom post types, taxonomías, tablas personalizadas, WP-Cron, REST y AJAX). La mayoría de las limitaciones se derivan de esas decisiones de diseño y de los servicios de terceros con los que el plugin puede integrarse opcionalmente.

La información que se presenta a continuación describe el comportamiento observado en el código fuente actual. Verifique cada punto con la versión actual del plugin antes de citarlo en un contrato con un cliente.

Limitaciones operativas

Dependencia de WP-Cron. Las importaciones programadas, la cola de imágenes, la cola del AI Assistant y la limpieza de retención de análisis dependen de la ejecución de WP-Cron. WP-Cron se activa mediante solicitudes y puede retrasarse o no ejecutarse en absoluto en sitios con poco tráfico. Utilice un cron de sistema real (llamando a wp-cron.php o al endpoint REST cron-import) para obtener un comportamiento predecible.
Bloqueos de concurrencia. Las ejecuciones de importación y de la cola de imágenes utilizan bloqueos transitorios (as24ci_cron_import_running, as24ci_image_queue_running). Si un proceso de ejecución muere (error fatal de PHP, tiempo de espera de hosting), el bloqueo puede sobrevivir al proceso. Los bloqueos obsoletos se eliminan automáticamente una vez que expira el TTL; la eliminación manual solo es necesaria si desea forzar una nueva ejecución antes.
Presupuestos de memoria y tiempo de ejecución. Las importaciones muy grandes (miles de vehículos por ejecución o vehículos con muchas imágenes) pueden superar los límites de memoria de PHP o de max_execution_time en hostings compartidos. Ajuste el modo cron y los límites de vehículos e imágenes por ejecución en consecuencia.
Ediciones manuales en campos importados. Los campos gestionados por el importador pueden ser sobrescritos por la siguiente importación. Utilice la capa de anulaciones manuales o el espacio de galería manual para el contenido que deba sobrevivir a las reimportaciones.
Modo en línea de imagen única para importaciones cron. Con la cola de imágenes habilitada (opción predeterminada recomendada), solo la primera imagen de cada vehículo se descarga en línea durante una importación cron. Las imágenes restantes son procesadas por el ejecutor asíncrono. Si el ejecutor no está funcionando, esas imágenes no aparecerán hasta que lo haga.

Limitaciones de seguridad y acceso

Las credenciales se almacenan en wp_options. El Client Secret de AutoScout24 y el secreto compartido del webhook se almacenan cifrados en reposo, y el token de cron se almacena como un hash HMAC unidireccional; otros ajustes y valores de opciones se almacenan como opciones ordinarias. Trate las copias de seguridad de la base de datos como si contuvieran secretos y rote las credenciales tras cualquier sospecha de compromiso. La clave de API de Gemini gestionada que utiliza el AI Assistant no se introduce ni se almacena como una opción de WordPress: se aprovisiona de forma centralizada a través de la API Platform de ADP Car Market Hub y se entrega al sitio como una credencial cifrada vinculada a la licencia. Los clientes nunca introducen ni ven esta clave.
Dependencia de capacidades. Las páginas de administración del plugin requieren la capacidad manage_as24_imports (concedida a los administradores por defecto). Los plugins de gestión de roles que eliminen esta capacidad bloquearán el acceso de los administradores a la administración del plugin.
Los endpoints REST públicos están desactivados por defecto y solo deben habilitarse si se conocen sus consumidores. Los endpoints de favoritos y análisis son públicos por diseño cuando se habilitan las funciones correspondientes, pero aplican validación de entrada.

Limitaciones de privacidad y cumplimiento

La analítica es de consentimiento voluntario (opt-in) pero, una vez habilitada, registra las interacciones de los visitantes en una tabla personalizada. El modo de requerir consentimiento está disponible, pero por defecto se permite cuando no hay ninguna integración de consentimiento conectada al filtro as24ci_analytics_consent_check. Verifique la gestión del consentimiento para su jurisdicción antes de habilitar la analítica.
Las alertas de búsqueda almacenan datos personales (correo electrónico y criterios de búsqueda). La tabla as24ci_search_agents se elimina al desinstalar, pero los clientes deben seguir cumpliendo con sus propias obligaciones de eliminación a petición del usuario durante el funcionamiento normal.
El AI Assistant transmite datos del vehículo al endpoint gestionado de Gemini. Cuando está habilitado, las instrucciones (prompts) y el contexto del anuncio se envían a la configuración gestionada de Google Gemini en ADP Car Market Hub. Revise el procesamiento de datos aplicable y los términos contractuales para la configuración de IA gestionada antes de habilitar las funciones de IA en producción.
Los códigos QR de las fichas técnicas en PDF utilizan un servicio de terceros por defecto. Reemplácelo con un generador autoalojado a través del filtro as24ci_pdf_qr_image_url si no se aceptan solicitudes externas en documentos imprimibles.
El envío de correos electrónicos utiliza wp_mail(). El hecho de que una notificación llegue al destinatario depende del sistema de correo configurado y de factores externos de entregabilidad. El plugin registra un indicador de intento de entrega, pero no garantiza la recepción.

Dependencias externas

Disponibilidad de la API de AutoScout24. Los errores de red y las caídas del proveedor se muestran como ejecuciones fallidas en los logs de importación; si no hay datos entrantes, no habrá nuevos vehículos, incluso con WP-Cron ejecutándose según lo programado.
Generación de PDF basada en el navegador. La ficha técnica en PDF depende del motor de impresión del navegador del visitante. La precisión del diseño varía entre navegadores.
Endpoint de IA gestionado. Sujeto a los límites de velocidad de Google Gemini, la obsolescencia de modelos y los cambios de precios fuera del control del plugin.
Receptores de webhooks. Las caídas persistentes del receptor pueden provocar la pérdida de eventos; el plugin reintenta las entregas fallidas un número limitado de veces. Diseñe los receptores para que sean idempotentes y respondan rápidamente.

Advertencias sobre la documentación

Esta documentación describe el comportamiento observado en el código fuente actual. En los casos en que el código fuente no permitía una respuesta concluyente, el texto utiliza una redacción cautelosa como "verificar con la versión actual del plugin antes de publicar".
Los identificadores de modelo predeterminados, los idiomas admitidos y los valores predeterminados de las opciones pueden cambiar entre versiones. Al publicar material de cara al cliente, copie los valores del código fuente del plugin actual en lugar de este documento de forma literal.

Mitigaciones

Configure un cron de sistema externo para llamar a wp-cron.php o al endpoint REST cron-import para aislar el trabajo programado del bajo tráfico.
Configure copias de seguridad de la base de datos fuera del sitio con el cifrado y los controles de acceso adecuados.
Combine el plugin con una integración de SMTP o correo transaccional para obtener notificaciones de leads fiables.
Utilice un entorno de pruebas (staging) para validar las instrucciones de IA, las plantillas de PDF y los receptores de webhooks antes de aplicar los cambios en producción.
Audite qué roles poseen manage_as24_imports y qué servicios de terceros están conectados.