Acceso a la API
Configure la URL base de la API, las credenciales, el acceso del vendedor y las verificaciones de conexión requeridas para importar el inventario de vehículos.
Ver documentación relacionadaINTEGRACIÓN TÉCNICA
Guía de integración para la importación de la API de AutoScout24 en WordPress
Conecte ADP Car Market Hub con WordPress, acceso a la API de AutoScout24, importaciones programadas, webhooks, plantillas, constructores de páginas, traducciones y flujos de trabajo de presentación del frontend.
Visión general de preparación para la integración
Una integración fiable comienza con el acceso correcto a la API, la configuración del servidor, el procesamiento en segundo plano y la compatibilidad del frontend.
Procesamiento programado
Use procesamiento cron fiable para importaciones recurrentes, manejo de imágenes, trabajos de limpieza y tareas en segundo plano.
Ver documentación relacionadaCompatibilidad con el tema
Valide las páginas del archivo, las páginas de detalle, los shortcodes y la salida de plantillas con el tema activo de WordPress.
Ver documentación relacionadaFlujo de trabajo de personalización
Use sobrescrituras de plantillas, CSS personalizado e integración con constructores de páginas sin modificar los archivos principales del plugin.
Ver documentación relacionadaPruebas y producción
Pruebe la integración en un entorno controlado antes de mover la configuración y las plantillas a producción.
Ver documentación relacionadaArquitectura de integración
ADP Car Market Hub conecta datos de vehículos externos con WordPress, procesamiento programado y capas de presentación del frontend.
| Capa | Componente | Rol en la integración |
|---|---|---|
| Externo | Fuente de datos externa | Proporciona datos de inventario de vehículos a través del acceso configurado a la API. |
| Conexión | Credenciales de API | Autoriza al plugin a solicitar datos de vehículos para la cuenta configurada. |
| Configuración | Ajustes del plugin | Almacena valores de conexión, ajustes de importación, opciones de diseño y preferencias operativas. |
| Procesando | Motor de importación | Procesa los datos del vehículo, actualiza el inventario y coordina la sincronización recurrente. |
| Almacenamiento | Base de datos de WordPress | Almacena registros de vehículos, metadatos, ajustes, registros, leads y datos analíticos. |
| Medios | Biblioteca de medios | Almacena imágenes de vehículos importadas y recursos de medios relacionados. |
| Frontend | Plantillas | Renderiza páginas de archivo, páginas de detalle y otros módulos del frontend. |
| Incrustación | Shortcodes | Permite la incrustación controlada del frontend en páginas, constructores y diseños personalizados. |
| Presentación | Páginas del frontend | Presenta el inventario importado a los visitantes del sitio web usando el tema activo. |
| Conversión | Leads y notificaciones | Captura consultas y soporta flujos de trabajo de contacto con el cliente. |
| Inteligencia | Analíticas y Market Insights | Proporciona visibilidad operativa e inteligencia de mercado donde esté configurado. |
Flujo de configuración y conexión
El proceso de integración debe completarse en un orden controlado para que los problemas de conexión se identifiquen antes de que comiencen las importaciones de producción.
- Preparar acceso a la API Recopile la URL base de la API, la URL del token, los identificadores del vendedor y las credenciales requeridas antes de configurar el plugin.
- Configurar ajustes del plugin Introduzca los valores de conexión en el administrador de WordPress y mantenga las credenciales fuera de la documentación pública y los repositorios públicos.
- Ejecutar la prueba de conexión Valide que el servidor puede alcanzar los endpoints de API configurados y recibir respuestas válidas.
- Ejecutar una importación controlada Comience con una importación limitada para confirmar los datos del vehículo, el manejo de medios y el comportamiento de actualización.
- Validar la salida del frontend Revise las páginas del archivo, las páginas de detalle, los shortcodes, las vistas de comparación, los favoritos y la salida de plantillas.
- Preparar producción Confirme el cron, las copias de seguridad, la migración de pruebas a producción, las páginas relevantes para SEO y las verificaciones de soporte antes del uso en producción.
Acceso a la API y credenciales externas
La configuración de la API define cómo el plugin se conecta a los datos de vehículos externos y autentica las solicitudes.
Valores de configuración requeridos
- URL base de la API
- URL del token
- ID de cliente
- Secreto de cliente
- ID del vendedor o identificador de cuenta
- Endpoint de prueba de conexión si está configurado
- Entorno de API (pruebas o producción)
Manejo de credenciales
- Nunca publique credenciales en la documentación
- Almacene credenciales solo en los ajustes del plugin
- Restrinja el acceso a administradores autorizados
- Valide las URLs de la API antes de importar
- Confirme los permisos de cuenta antes de ir a producción
- Rote las credenciales cuando cambie el acceso
Cron, automatización y webhooks
Las importaciones recurrentes, las rutinas de limpieza y los eventos de integración requieren un procesamiento en segundo plano fiable.
Configuración de cron del servidor
Se recomienda el cron del lado del servidor para importaciones de producción fiables, procesos de limpieza y tareas programadas en segundo plano.
Configuración de cron del servidorIntegración de webhooks
La documentación de webhooks explica cómo se pueden manejar los eventos o señales de integración externos donde sea compatible.
Integración de webhooksFiabilidad en segundo plano
Los trabajos de importación deben monitorizarse para que las llamadas API fallidas, las colas de imágenes o los procesos retrasados puedan identificarse tempranamente.
Cron y procesamiento en segundo planoIntegración de tema, plantilla y constructor de páginas
El plugin debe integrarse con el tema activo de WordPress sin editar los archivos principales del plugin.
Integración de tema y plantilla
Salida del tema
Use la integración del tema y las sobrescrituras de plantillas para controlar cómo se renderizan las páginas del archivo, las páginas de detalle del vehículo y los módulos del frontend.
- Plantillas de archivo
- Plantillas de detalle
- Sobrescrituras de plantillas
- Verificaciones de compatibilidad del tema
- CSS personalizado
- Validación en pruebas
Integración con constructores de páginas
Flujos de trabajo del constructor
Use flujos de trabajo compatibles con constructores de páginas donde sea compatible mientras mantiene intacta la salida de inventario controlada por el plugin.
- Colocación de shortcodes
- Secciones del constructor
- Contenedores de diseño
- Bloques de contenido reutilizables
- Verificaciones responsive
- Validación del frontend
Salida del frontend e integración de shortcodes
La salida del frontend debe probarse con datos de vehículos reales, filtros configurados y el tema activo antes de ir a producción.
| Componente | Propósito | Documentación |
|---|---|---|
| Archivo de vehículos | Muestra el inventario importado con filtros, ordenación y tarjetas de vehículos. | Archivo de vehículos |
| Páginas de detalle del vehículo | Muestra la galería, precios, especificaciones, acciones de contacto e información relacionada del vehículo. | Páginas de detalle del vehículo |
| Comparar | Permite a los visitantes comparar vehículos seleccionados. | Comparar |
| Favoritos | Permite a los visitantes guardar vehículos para revisar más tarde. | Favoritos |
| Alertas de búsqueda | Soporta flujos de trabajo de búsqueda guardada o alertas donde esté configurado. | Alertas de búsqueda |
| Shortcodes | Permite la incrustación controlada de la salida del plugin en páginas de WordPress y diseños de constructores. | Referencia de shortcodes |
Traducción y localización
El plugin y la documentación están preparados para flujos de trabajo multilingües. El inglés sigue siendo el idioma de origen, mientras que las carpetas traducidas usan nombres de carpetas y archivos localizados.
Estructura de documentación multilingüe
- Idioma de origen Inglés
- Carpetas de traducción preparadas Alemán · Francés · Italiano · Español · Neerlandés
- Nombrado de carpetas Nombres de carpetas y archivos localizados por idioma
- Mapa de traducción translation-map.md conecta los archivos localizados con la fuente en inglés
- Cadenas del plugin Flujos de trabajo de traducción compatibles con Poedit
Flujo de trabajo de pruebas a producción
Un flujo de trabajo controlado de pruebas a producción reduce el riesgo al mover la configuración de la API, las plantillas y la salida del frontend a producción.
- Entorno de pruebas preparado
- Credenciales de API verificadas
- Prueba de conexión superada
- Importación limitada probada
- Imágenes de vehículos verificadas
- Página del archivo revisada
- Páginas de detalle revisadas
- Shortcodes revisados
- Sobrescrituras de plantillas probadas
- Estrategia de cron confirmada
- Copia de seguridad disponible
- Lista de verificación para producción completada
Documentación de integración
Abra los documentos de integración relevantes directamente en el repositorio de documentación pública.
| Documento | Enlace |
|---|---|
| Sección de la guía de integración | Sección de la guía de integración |
| Configuración de la API de AutoScout24 | Configuración de la API de AutoScout24 |
| Credenciales de API externa | Credenciales de API externa |
| Configuración de cron del servidor | Configuración de cron del servidor |
| Integración de webhooks | Integración de webhooks |
| Integración con el tema | Integración con el tema |
| Integración con constructores de páginas | Integración con constructores de páginas |
| Guía de sobrescritura de plantillas | Guía de sobrescritura de plantillas |
| Guía de CSS personalizado | Guía de CSS personalizado |
| Guía de traducción y Poedit | Guía de traducción y Poedit |
| Migración de pruebas a producción | Migración de pruebas a producción |
Los enlaces de documentación siguen el idioma activo del sitio web. El inglés es el idioma de origen. Las carpetas de otros idiomas usan nombres de carpetas y archivos localizados.