Documentación · Descripción general
Descripción general del producto
Este documento presenta el plugin ADP Car Market Hub WordPress: qué hace, a quién va dirigido y cómo se integra en el sitio web de un concesionario típico.
Cuándo utilizar este documento
Lea este documento cuando esté evaluando el plugin por primera vez, cuando necesite un resumen breve para compartir con un colega o parte interesada, o cuando desee confirmar si un caso de uso particular está contemplado antes de leer las secciones detalladas.
Descripción general
ADP Car Market Hub conecta un sitio de WordPress a la API oficial de AutoScout24 y convierte su inventario de vehículos en contenido nativo de WordPress. Los anuncios importados se almacenan como un tipo de contenido personalizado (custom post type o as24ci_car), enriquecido con taxonomías de atributos de vehículos, y se exponen a través de las plantillas, shortcodes y herramientas de administración del plugin.
El plugin está diseñado para concesionarios de coches y grupos de concesionarios que ya disponen de acceso a la API de AutoScout24. No realiza raspado de datos (scraping) del sitio web público de AutoScout24. Todos los datos de los vehículos se recuperan a través del endpoint de la API configurado con las credenciales proporcionadas por su proveedor.
Capacidades principales:
- Importar y sincronizar anuncios de vehículos, imágenes, equipamiento y precios desde la API configurada.
- Programar importaciones recurrentes a través de WP-Cron o un cron externo del sistema con un activador REST protegido por token.
- Gestionar vehículos en la administración de WordPress y presentarlos en el front-end a través de las plantillas integradas de archivo, ficha individual, comparador y favoritos.
- Capturar clientes potenciales (leads) desde formularios de contacto y solicitudes de prueba de conducción (Test Drive) y redirigirlos a la dirección de correo del destinatario configurado.
- Mantener contactos de ventas del concesionario gestionados por el plugin (CMH Team) que se muestran en las páginas de los vehículos y se utilizan para canalizar los leads.
- Complementos opcionales para descripciones generadas por IA, textos de marketing de Content Studio, alertas de búsqueda (Smart Stock Alerts), analítica, calculadora de financiación, PDF datasheet, ubicaciones, Market Insights y más.
Audiencia
- Personal del concesionario y editores: gestionan el inventario, los leads y la presentación en el front-end a través de la administración de WordPress.
- Administradores del sitio: instalan, configuran y operan el plugin, incluyendo credenciales, cron e integraciones.
- Desarrolladores e integradores: extienden el plugin, crean integraciones personalizadas o realizan modificaciones de plantillas (theme overrides).
Dónde encaja esto en la documentación
La documentación en español se divide en las siguientes secciones principales:
- Empezando — instalación y primera conexión.
- Requisitos del sistema — requisitos previos de alojamiento, PHP y red.
- Manual del usuario — flujos de trabajo editoriales diarios.
- Referencia de administración — explicación de cada pantalla de administración.
- Documentación técnica — arquitectura, modelo de datos y comportamiento interno.
- Guía de integración — credenciales, cron del servidor, temas y constructores de páginas.
- Guía del frontend — lo que ven los visitantes y cómo se compone.
- Operaciones y mantenimiento — ejecución del plugin en producción.
- Privacidad, seguridad y cumplimiento — manejo de datos, consentimiento y control de acceso.
- Resolución de problemas — soluciones guiadas basadas en problemas.
- Notas de la versión — cambios por versión.
- Apéndices — referencias rápidas de shortcodes, ajustes, hooks y endpoints.
- Documentación para desarrolladores — puntos de extensión para código personalizado.
Fuera de alcance
- Realizar raspado (scraping) de páginas HTML de AutoScout24 o de cualquier tercero.
- Actuar como sustituto de un contrato de concesionario de AutoScout24 o del acceso a su API.
- Alojar el propio sitio de WordPress; el plugin se ejecuta dentro de una instalación de WordPress gestionada por el cliente.
Notas de funcionamiento
- El plugin utiliza la tabla de opciones de WordPress para almacenar su configuración. Los secretos confidenciales se protegen en reposo: el secreto de cliente de la API de AutoScout24 se almacena utilizando cifrado autenticado AES-256-GCM (con la clave derivada de las sales de WordPress), y el token de importación del cron se almacena como un hash unidireccional HMAC-SHA256. El token del cron en texto plano solo se muestra en la administración durante un breve período tras su generación. Las copias de seguridad de la base de datos deben seguir tratándose como información confidencial, ya que también contienen leads, ajustes y otros datos operativos.
- Las funciones opcionales como el AI Assistant, los Webhooks, las alertas de búsqueda y la API REST pública están desactivadas hasta que un administrador las active.
- Las etiquetas de administración localizadas y los archivos de traducción se incluyen con el plugin. La documentación en inglés es el idioma de origen y puede utilizar una redacción cautelosa cuando el comportamiento dependa de la configuración del cliente. Verifique cualquier comportamiento que pretenda publicar de cara al cliente con la versión actual del plugin.