Accès API
Configurez l’URL de base de l’API, les identifiants, l’accès vendeur et les vérifications de connexion nécessaires à l’import de l’inventaire véhicules.
Voir la documentation associéeINTÉGRATION TECHNIQUE
Guide d’intégration pour l’import via l’API AutoScout24 sur WordPress
Connectez ADP Car Market Hub à WordPress, à l’accès API AutoScout24, aux imports planifiés, aux webhooks, aux modèles, aux page builders, aux traductions et aux flux de présentation côté client.
Vue d’ensemble de l’aptitude à l’intégration
Une intégration fiable commence par un accès API correct, une bonne configuration serveur, des traitements en arrière-plan et une compatibilité côté client.
Traitements planifiés
Utilisez un traitement cron fiable pour les imports récurrents, la gestion des images, les tâches de nettoyage et les tâches en arrière-plan.
Voir la documentation associéeCompatibilité avec le thème
Validez les pages d’archive, les pages de détail, les shortcodes et la sortie des modèles avec le thème WordPress actif.
Voir la documentation associéeFlux de personnalisation
Utilisez les surcharges de modèles, le CSS personnalisé et l’intégration aux page builders sans modifier les fichiers cœur du plugin.
Voir la documentation associéePré-production et mise en production
Testez l’intégration dans un environnement contrôlé avant de basculer la configuration et les modèles en production.
Voir la documentation associéeArchitecture d’intégration
ADP Car Market Hub connecte les données véhicules externes à WordPress, aux traitements planifiés et aux couches de présentation côté client.
| Couche | Composant | Rôle dans l’intégration |
|---|---|---|
| Externe | Source de données externe | Fournit les données d’inventaire véhicules via l’accès API configuré. |
| Connexion | Identifiants API | Autorisent le plugin à demander les données véhicules pour le compte configuré. |
| Configuration | Paramètres du plugin | Stockent les valeurs de connexion, les paramètres d’import, les choix de mise en page et les préférences opérationnelles. |
| Traitement | Moteur d’import | Traite les données véhicules, met à jour l’inventaire et coordonne la synchronisation récurrente. |
| Stockage | Base de données WordPress | Stocke les enregistrements véhicules, métadonnées, paramètres, journaux, leads et données analytiques. |
| Médias | Bibliothèque de médias | Stocke les images de véhicules importées et les médias associés. |
| Côté client | Modèles | Rend les pages d’archive, les pages de détail et les autres modules côté client. |
| Embarquement | Shortcodes | Permet l’embarquement contrôlé côté client dans les pages, les builders et les mises en page personnalisées. |
| Présentation | Pages côté client | Présentent l’inventaire importé aux visiteurs du site via le thème actif. |
| Conversion | Leads et notifications | Capturent les demandes et soutiennent les flux de contact client. |
| Intelligence | Analyses et Market Insights | Apportent visibilité opérationnelle et intelligence de marché lorsqu’elles sont configurées. |
Flux de mise en place et de connexion
Le processus d’intégration doit suivre un ordre contrôlé afin que les soucis de connexion soient identifiés avant les imports en production.
- Préparer l’accès API Recueillez l’URL de base de l’API, l’URL de jeton, les identifiants vendeur et les identifiants requis avant de configurer le plugin.
- Configurer les paramètres du plugin Saisissez les valeurs de connexion dans l’administration WordPress et tenez les identifiants à l’écart de la documentation publique et des dépôts publics.
- Lancer le test de connexion Vérifiez que le serveur peut joindre les endpoints API configurés et reçoit des réponses valides.
- Lancer un import contrôlé Commencez par un import limité pour confirmer les données véhicules, la gestion des médias et le comportement des mises à jour.
- Valider la sortie côté client Examinez les pages d’archive, les pages de détail, les shortcodes, les vues de comparaison, les favoris et la sortie des modèles.
- Préparer la mise en production Confirmez le cron, les sauvegardes, la migration pré-production vers production, les pages SEO pertinentes et les vérifications de support avant l’usage en production.
Accès API et identifiants externes
La configuration de l’API définit comment le plugin se connecte aux données véhicules externes et authentifie les requêtes.
Valeurs de configuration requises
- URL de base de l’API
- URL du token
- Client ID
- Client Secret
- Identifiant vendeur ou identifiant de compte
- Endpoint de test de connexion, le cas échéant
- Environnement API (pré-production ou production)
Gestion des identifiants
- Ne publiez jamais les identifiants dans la documentation
- Stockez les identifiants uniquement dans les paramètres du plugin
- Restreignez l’accès aux administrateurs autorisés
- Validez les URL d’API avant tout import
- Confirmez les permissions du compte avant la mise en production
- Faites tourner les identifiants lorsque les accès changent
Cron, automatisation et webhooks
Les imports récurrents, routines de nettoyage et événements d’intégration nécessitent un traitement en arrière-plan fiable.
Mise en place du cron serveur
Le cron côté serveur est recommandé pour des imports en production fiables, des processus de nettoyage et des tâches en arrière-plan planifiées.
Mise en place du cron serveurIntégration des webhooks
La documentation des webhooks explique comment les événements ou signaux d’intégration externe peuvent être traités lorsqu’ils sont pris en charge.
Intégration des webhooksFiabilité de l’arrière-plan
Les jobs d’import doivent être surveillés afin que les appels API en échec, les files d’images ou les processus retardés soient identifiés tôt.
Cron et traitements en arrière-planIntégration au thème, aux modèles et aux page builders
Le plugin doit être intégré au thème WordPress actif sans éditer les fichiers cœur du plugin.
Intégration au thème et aux modèles
Sortie du thème
Utilisez l’intégration au thème et les surcharges de modèles pour piloter le rendu des pages d’archive, des pages de détail véhicule et des modules côté client.
- Modèles d’archive
- Modèles de détail
- Surcharges de modèles
- Vérifications de compatibilité du thème
- CSS personnalisé
- Validation en pré-production
Intégration aux page builders
Flux page builder
Utilisez des flux compatibles page builder lorsqu’ils sont pris en charge, tout en gardant intacte la sortie de l’inventaire pilotée par le plugin.
- Placement des shortcodes
- Sections du builder
- Conteneurs de mise en page
- Blocs de contenu réutilisables
- Vérifications responsives
- Validation côté client
Sortie côté client et intégration des shortcodes
La sortie côté client doit être testée avec de vraies données véhicules, les filtres configurés et le thème actif avant la mise en production.
| Composant | Objet | Documentation |
|---|---|---|
| Archive véhicules | Affiche l’inventaire importé avec filtres, tri et cartes véhicules. | Archive véhicules |
| Pages de détail véhicule | Affiche la galerie, le prix, les spécifications, les actions de contact et les informations véhicules associées. | Pages de détail véhicule |
| Comparer | Permet aux visiteurs de comparer les véhicules sélectionnés. | Comparer |
| Favoris | Permet aux visiteurs d’enregistrer des véhicules pour examen ultérieur. | Favoris |
| Alertes de recherche | Prend en charge les flux de recherches enregistrées ou d’alertes lorsqu’ils sont configurés. | Alertes de recherche |
| Shortcodes | Permet l’embarquement contrôlé de la sortie du plugin dans les pages WordPress et les mises en page de builder. | Référence des shortcodes |
Traduction et localisation
Le plugin et la documentation sont préparés pour des flux multilingues. L’anglais reste la langue source, tandis que les dossiers traduits utilisent des noms de dossiers et de fichiers localisés.
Structure de la documentation multilingue
- Langue source Anglais
- Dossiers de traduction préparés Allemand · Français · Italien · Espagnol · Néerlandais
- Nommage des dossiers Noms de dossiers et de fichiers localisés par langue
- Carte de traduction translation-map.md relie les fichiers localisés à la source anglaise
- Chaînes du plugin Flux de traduction compatibles Poedit
Flux pré-production vers production
Un flux pré-production vers production contrôlé réduit le risque lors du passage en production de la configuration API, des modèles et de la sortie côté client.
- Environnement de pré-production préparé
- Identifiants API vérifiés
- Test de connexion réussi
- Import limité testé
- Images de véhicules vérifiées
- Page d’archive examinée
- Pages de détail examinées
- Shortcodes examinés
- Surcharges de modèles testées
- Stratégie cron confirmée
- Sauvegarde disponible
- Liste de vérification de mise en production complétée
Documentation d’intégration
Ouvrez directement les documents d’intégration pertinents dans le dépôt de documentation public.
| Document | Lien |
|---|---|
| Section Guide d’intégration | Section Guide d’intégration |
| Mise en place de l’API AutoScout24 | Mise en place de l’API AutoScout24 |
| Identifiants API externes | Identifiants API externes |
| Mise en place du cron serveur | Mise en place du cron serveur |
| Intégration des webhooks | Intégration des webhooks |
| Intégration au thème | Intégration au thème |
| Intégration aux page builders | Intégration aux page builders |
| Guide des surcharges de modèles | Guide des surcharges de modèles |
| Guide CSS personnalisé | Guide CSS personnalisé |
| Guide de traduction et Poedit | Guide de traduction et Poedit |
| Migration pré-production vers production | Migration pré-production vers production |
Les liens de documentation suivent la langue active du site. L’anglais est la langue source. Les autres dossiers de langue utilisent des noms de dossiers et de fichiers localisés.