Documentación · Descripción general
Resumen de características
Este documento resume las características del plugin ADP Car Market Hub y remite a la documentación detallada de cada área.
Cuándo utilizar este documento
Lea este documento cuando necesite un mapa de una sola página con todo lo que el plugin puede hacer, cuando esté decidiendo qué características opcionales activar o cuando desee encontrar la referencia detallada adecuada rápidamente.
Descripción general
El plugin agrupa su funcionalidad en las siguientes áreas de características. Cada área se ofrece a través de una o más pestañas de administración y está documentada en profundidad en la sección correspondiente de este manual.
Importación y sincronización
- Importa listados de vehículos desde el endpoint de la API de AutoScout24 configurado hacia el custom post type
as24ci_car. - Importa imágenes de vehículos, con conversión opcional a WebP (requiere GD o Imagick) y un número máximo configurable de imágenes por vehículo.
- Detección de cambios: se almacena un hash de contenido y un hash de imagen por vehículo para omitir los listados que no hayan cambiado en las ejecuciones posteriores.
- Sincronización completa opcional: los vehículos que desaparecen del feed remoto se eliminan localmente, incluidos sus archivos adjuntos importados. Activación opcional por seguridad.
- Importaciones completas manuales a través del Batch-Wizard con tamaño de lote adaptativo, progreso en vivo, tiempo estimado de finalización (ETA) y controles de pausa/reanudación/aborto.
Consulte Motor de importación y Referencia del importador de vehículos.
Automatización y programación
- Programador WP-Cron integrado con intervalos de cada hora, cada 6 horas, dos veces al día, diario y personalizados (mínimo 15 minutos).
- Endpoint REST de cron protegido por token para activadores de cron externos del sistema.
- Límite de vehículos por ejecución y modo de cola de imágenes configurables para garantizar la robustez del cron en hostings compartidos.
- Procesador de cola de imágenes (worker) que procesa los archivos adjuntos de forma asíncrona para evitar tiempos de espera (timeouts) de PHP.
Consulte Eventos de cron y programador y Configuración del cron del servidor.
Modelo de datos de vehículos
- Una fila por vehículo en una tabla dedicada
as24_vehiclescon columnas indexadas para consultas comunes. - 15 taxonomías nativas de atributos de vehículos de WordPress (marca, modelo, tipo de carrocería, estado, tipo de combustible, transmisión, tracción, color exterior/interior, norma de emisiones, etiqueta energética, categoría del vehículo, disposición de cilindros, tipo de garantía, detalles de la garantía).
- Las claves de post meta de compatibilidad con versiones anteriores reflejan los campos más utilizados para garantizar la compatibilidad con el tema.
- Una capa de
manual_overridespermite a los administradores fijar valores de campos para que sobrevivan a las reimportaciones.
Consulte Esquema de la base de datos, Custom Post Types y taxonomías y Modelo de datos.
Presentación en el front-end
- Plantillas integradas de archivo y de vehículo único con galería de imágenes, lista de equipamiento, detalles del vehículo, formulario de contacto y complementos opcionales.
- Layout Manager: configure los filtros de búsqueda, las tarjetas de archivo, los bloques de vehículo único y el diseño de favoritos/comparador desde la administración.
- Rutas de invalidación (overrides) del tema para
archive-as24ci_car.phpysingle-as24ci_car.php. - Shortcodes para el archivo, filtro de búsqueda, página de comparación, página de favoritos y tarjetas de ubicación/horarios de apertura. Consulte Referencia de shortcodes.
- Flujos opcionales de Favoritos / Lista de deseos (almacenamiento local del navegador) y Comparador de vehículos en el front-end, allí donde se coloquen los shortcodes o diseños correspondientes.
- Calculadora de financiación opcional en las páginas de detalles del vehículo, con tasa predeterminada, plazo, pago inicial y ubicación configurables (activa donde se habilite en Diseño y estilos).
- Generación y descarga opcional de PDF datasheet por vehículo, allí donde el PDF Manager esté configurado y la función esté habilitada.
- Tarjetas opcionales de Ubicaciones / horarios de apertura para las sedes del concesionario, allí donde se complete el área de Ubicaciones y se coloque el shortcode correspondiente.
Leads y formulario de contacto
- Formulario de contacto integrado en las páginas de vehículos individuales, almacenado como entradas
as24ci_lead. - Campos visibles, casilla de verificación de consentimiento, mensajes de éxito y error configurables.
- Plantillas de correo electrónico personalizables para la notificación al concesionario y la confirmación al cliente.
- Exportación a CSV desde la pestaña de administración Leads.
Consulte Almacenamiento y procesamiento de leads y Referencia de leads.
Contactos de ventas (CMH Team)
- Contactos de ventas del concesionario gestionados por el plugin, mantenidos en el menú superior independiente CMH Team. Los miembros del equipo no necesitan un inicio de sesión en WordPress.
- Cada contacto almacena un nombre, foto opcional, correo electrónico y teléfono, que se muestran como tarjeta de contacto en las páginas de detalles del vehículo.
- Los contactos se pueden asignar por vehículo, por ubicación del concesionario/vendedor o como valor predeterminado global, conservando las elecciones manuales tras las reimportaciones y con reglas de asignación automática opcionales.
- El contacto resuelto se utiliza como destinatario preferente para los leads, con una copia opcional al correo electrónico general del concesionario.
Consulte CMH Team y enrutamiento de contactos.
Reserva de prueba de conducción
- Formulario opcional de prueba de conducción en las páginas de detalles del vehículo.
- Días de la semana disponibles, ventana horaria diaria, duración de las citas y fechas excluidas configurables.
- Las solicitudes de reserva se almacenan como leads y se reenvían al correo electrónico del destinatario configurado.
Consulte Solicitudes de prueba de conducción.
Alertas de búsqueda (Smart Stock Alerts)
- Los visitantes pueden suscribirse a criterios de búsqueda guardados y recibir una notificación cuando se importe un vehículo que coincida.
- Flujo de doble opt-in que cumple con el RGPD: los suscriptores deben confirmar a través de un enlace de correo electrónico antes de que se envíe cualquier notificación.
- Las notificaciones se activan automáticamente cuando se importan vehículos que coinciden.
- Las suscripciones se almacenan en la tabla dedicada
as24ci_search_agentsy se gestionan en la pestaña de administración Search Alerts.
Consulte Front-end de alertas de búsqueda, Referencia de alertas de búsqueda y Doble opt-in de alertas de búsqueda.
AI Assistant (opcional)
- Genera descripciones de vehículos, meta títulos y descripciones SEO, textos alternativos de imágenes y aspectos destacados del equipamiento.
- Utiliza la configuración gestionada de Google Gemini en ADP Car Market Hub. No se requiere selección de proveedor, selección de modelo ni introducción de clave API en el backend de WordPress; el aprovisionamiento de IA específico para el cliente lo completa AD Promotion tras la instalación.
- Idioma, tono, longitud objetivo y plantilla de instrucción (prompt) personalizada configurables.
- Una cola en segundo plano procesa las tareas de IA de forma asíncrona a través de un intervalo personalizado de WP-Cron de 5 minutos.
Consulte Referencia de AI Assistant y Notas técnicas de AI Assistant.
Content Studio (opcional)
- Convierte un vehículo que ya está en el inventario en texto de marketing listo para publicar en redes sociales y otros canales: Facebook, Instagram, TikTok, Perfil de Empresa en Google, WhatsApp, un boletín informativo del concesionario y el sitio web.
- La generación se puede ejecutar en uno o más idiomas a la vez, con un tono predeterminado configurable, la voz de marca del concesionario y directrices obligatorias de cumplimiento/descargo de responsabilidad.
- La generación de texto utiliza una clave API de Google propiedad del concesionario y almacenada de forma encriptada; el plugin produce texto (y, para algunos formatos, un borrador de imagen de marketing) para copiar y publicar manualmente, y nunca publica en las redes sociales en su nombre.
- Disponible donde se incluya en la licencia; lee únicamente los datos del vehículo y escribe exclusivamente en sus propios registros de Content Studio.
Consulte Referencia de Content Studio.
Analytics
- Seguimiento en el lado del servidor de las visitas a páginas, vistas de archivo/comparador/favoritos, búsquedas con filtros, eventos de apertura de contacto y envíos de leads.
- Gráficos diarios y una clasificación de los mejores vehículos en la pestaña de administración Analytics.
- Ventana de retención configurable con un cron de limpieza diario.
- Control de consentimiento opcional a través del filtro
as24ci_analytics_consent_check.
Consulte Seguimiento de Analytics y Retención de Analytics.
Market Insights (opcional)
- Vistas agregadas de inteligencia de mercado y evaluación de precios para el inventario local, presentadas a través de la página de administración Market Insights.
- Activo donde esté configurado; dependiendo de la configuración del plugin instalado, algunos paneles pueden requerir una fuente de datos gestionada adicional provista por AD Promotion.
EnVKV / Etiquetado energético (opcional)
- Configuración para la Ordenanza alemana de etiquetado energético de vehículos (EnVKV / Pkw-EnVKV), que incluye campos de consumo, emisiones y etiqueta energética utilizados en las tarjetas de archivo, páginas de detalles del vehículo y el PDF datasheet.
- Activo donde esté habilitado y configurado para los mercados pertinentes; se puede dejar sin tocar en las instalaciones que no requieran el etiquetado EnVKV.
Webhooks (opcional)
- Eventos salientes de
new_leadynew_importenviados a las URL configuradas por el administrador. - Firma HMAC-SHA256 opcional para la verificación del receptor.
- Estrategia de reintentos acotada para fallos temporales.
Consulte Webhooks y Referencia de eventos de webhook.
REST API (opcional)
- Endpoints públicos de lectura de
GET /wp-json/as24ci/v1/vehiclesyGET /wp-json/as24ci/v1/vehicles/{id}para consumidores externos. - Un asistente de favoritos utilizado por la página de favoritos del front-end.
- Un endpoint público de seguimiento de analíticas utilizado por el script del front-end.
- Un endpoint
GET /wp-json/as24ci/v1/cron-importprotegido por token para programadores externos.
Consulte Endpoints de la REST API y Referencia de endpoints REST.
Diseño y maquetación
- Colores de marca, tipografía, distintivos, configuración de la galería y CSS personalizado a través de la pestaña Design & Styles.
- El Layout Manager organiza los filtros de búsqueda, las tarjetas de archivo, los bloques de vehículo único y los diseños de comparador/favoritos sin necesidad de código.
- La pestaña de mapeo edita las etiquetas y la visibilidad de cada campo importado.
Consulte Referencia de diseño y estilos, Referencia del Layout Manager y Referencia de mapeo.
Operaciones y mantenimiento
- Registro detallado (logging) con rotación automática al alcanzar un límite de 10 MB.
- Pestaña de Sistema y Ayuda con comprobaciones del entorno, estado del cron, estado de la cola de imágenes, estado del registro, prueba de conexión y exportación de diagnósticos.
- Pestaña de Herramientas para diagnósticos de entradas individuales, simulacros de importación (dry-run) e importación/exportación de la configuración del plugin.
Consulte Operaciones y mantenimiento.