Documentation · Première prise en main

Première configuration

Ce guide explique ce qu'un administrateur WordPress doit configurer après avoir activé l'extension ADP Car Market Hub, et dans quel ordre. Suivre la séquence recommandée permet d'éviter les retouches les plus courantes — par exemple, lancer une importation avant que la connexion API ne soit validée, ou passer en production avant que le frontend n'ait été vérifié sur une vraie page de véhicule.

Ce document couvre le flux de configuration. Des documents de référence détaillés pour chaque onglet d'administration sont disponibles dans la section Référence de l'administrateur. Une référence dédiée à l'Assistant de première configuration intégré à l'extension est fournie dans Setup Wizard Reference.

Assistant de première configuration

ADP Car Market Hub est livré avec un Assistant de première configuration qui guide l'administrateur à travers les choix de configuration les plus courants en sept étapes concises. La première étape est l'activation de la licence, qui est obligatoire : tant qu'une licence valide n'est pas activée, chaque étape opérationnelle de l'assistant (et chaque onglet d'administration de l'extension autre que Réglages) reste verrouillé. Une fois la licence active, les étapes restantes constituent le point d'entrée recommandé pour les évaluations de démonstration et les déploiements réels de AutoScout24, mais ne sont pas obligatoires — chaque option qu'elles proposent peut également être configurée manuellement à l'aide des onglets d'administration habituels documentés dans la Référence de l'administrateur.

Ce que fait l'assistant

Active votre licence lors de la première étape. La licence déverrouille les zones premium de l'extension ; sans elle, l'assistant ne peut pas dépasser l'écran de licence et les autres onglets d'administration affichent un écran « Licence requise ».
Permet à l'administrateur de choisir entre la Configuration de démonstration (installe des véhicules de démonstration, applique les valeurs par défaut de démonstration et active l'analyse afin que le Tableau de bord et les pages d'Analyse aient des données à afficher) et la Configuration réelle de AutoScout24 (enregistre les identifiants réels et les pages sélectionnées sans installer de données de démonstration).
Saisit le profil du concessionnaire (nom, adresse, coordonnées, logo).
Saisit la connexion AutoScout24 (Client ID, Client Secret, Seller ID, API Base URL).
Crée éventuellement les pages publiques Cars, Compare Cars et Favorites avec les shortcodes canoniques.
Active ou désactive les fonctionnalités par défaut les plus courantes (partage social, PDF datasheet, code QR du PDF, coûts d'utilisation pour 100 km, Comparer, Favoris, Alertes de recherche, suivi Analytics).
Marque la configuration comme terminée et renvoie l'administrateur vers le Tableau de bord.

Quand l'assistant apparaît-il ?

Après la première activation de l'extension, une notification d'administration intitulée Welcome to ADP Car Market Hub apparaît en haut de chaque page d'administration WordPress.
La notification n'est pas une redirection forcée — l'administrateur peut continuer à naviguer sur WordPress et lancer l'assistant plus tard.
La notification ne s'affiche que lorsque toutes les conditions suivantes sont remplies :
L'utilisateur actuel dispose de la capacité de gestion de l'extension.
Un horodatage de première activation a été enregistré.
L'assistant n'a pas été marqué comme terminé.
L'assistant n'a pas été marqué comme ignoré.
Les mises à niveau de l'extension qui ne déclenchent pas une nouvelle activation ne font pas apparaître la notification sur les installations existantes.

Comment lancer l'assistant

Cliquez sur Start Setup Wizard dans la notification d'accueil, ou
Ouvrez Car Market Hub → Dashboard et utilisez le lien Run Setup Wizard situé vers le haut, ou
Ouvrez Car Market Hub → Tools et utilisez la carte Setup Wizard.

L'assistant est enregistré en tant que page d'administration masquée accessible à l'adresse wp-admin/admin.php?page=as24ci-setup-wizard. Des vérifications de capacités et de nonces sont appliquées à chaque étape.

Comment ignorer l'assistant

Cliquez sur Skip for now dans la notification d'accueil. La notification n'apparaîtra plus lors des chargements ultérieurs des pages d'administration.
L'assistant reste accessible depuis le Tableau de bord et l'onglet Outils afin de pouvoir être repris à tout moment.

Étapes de l'assistant

Licence — saisissez et activez votre clé de licence. Cette étape est imposée en premier ; l'assistant ne peut passer à aucune étape opérationnelle tant que la licence n'est pas opérationnelle. La clé de licence est en écriture seule — elle n'est jamais pré-remplie à l'écran.
Mode — choisissez la configuration de démonstration ou la configuration réelle de AutoScout24 ; sélectionnez le pays du concessionnaire, la devise et la langue d'administration.
Profil du concessionnaire — nom, rue, code postal, ville, pays, téléphone, e-mail, site web, logo.
AutoScout24 — Client ID, Client Secret, Seller ID et API Base URL. Le champ Client Secret est intentionnellement rendu vide (voir Configuration des identifiants API).
Pages — pour chaque page publique (Cars, Compare Cars, Favorites), choisissez Create automatically, Use existing page ou Skip.
Fonctionnalités — activez ou désactivez les fonctionnalités par défaut listées ci-dessus.
Terminer — examinez le résumé et confirmez. En mode Démo, l'étape finale déclenche également l'installateur de données de démonstration existant ; en mode Réel, elle enregistre uniquement les réglages de l'assistant.

Sécurité des installations existantes

L'activation de l'extension n'injecte que des valeurs par défaut non destructives ; elle n'écrase jamais les valeurs d'options existantes.
Désactiver et réactiver l'extension ne rouvre pas l'assistant automatiquement et n'écrase pas les réglages.
L'assistant ne modifie que les réglages dont l'administrateur soumet réellement les champs de formulaire.
La configuration de démonstration est le seul chemin qui installe des données de démonstration et réinitialise les options contrôlées par la démo ; il s'agit d'une opération explicite de réinitialisation et d'injection. La configuration réelle est non destructive en ce qui concerne les véhicules et les réglages des clients.

Pour plus de détails sur les drapeaux, les capacités, l'URL de la page d'administration masquée et le comportement de stockage des étapes, voir Setup Wizard Reference.

Quand utiliser ce document

Utilisez ce document si vous êtes en train de :

Configurer ADP Car Market Hub sur une installation fraîchement activée.
Reconfigurer l'extension après une migration de serveur, une reconstruction d'environnement ou une promotion d'un environnement de pré-production vers la production.
Documenter un processus d'intégration reproductible pour le site d'un nouveau client.

Le public cible est un administrateur WordPress qui a déjà complété le Guide d'installation et qui a accès aux identifiants API AutoScout24 fournis par le compte du concessionnaire ou son partenaire d'intégration.

Avant de commencer

Confirmez les points suivants avant de commencer la configuration :

L'extension est installée et activée et le menu Car Market Hub apparaît dans l'administration WordPress.
Le site respecte tous les points de la Liste de contrôle de pré-installation.
Vous disposez de votre clé de licence ADP Car Market Hub. La licence est requise pour déverrouiller les zones premium de l'extension : tant qu'elle n'est pas activée, chaque onglet d'administration à l'exception de Réglages affiche un écran « Licence requise » et les importations, le cron ainsi que les autres fonctionnalités restent verrouillés.
Vous disposez des identifiants API AutoScout24 requis par votre compte : API Base URL, Seller ID(s), Client ID et Client Secret. Ceux-ci proviennent du compte AutoScout24 du concessionnaire ou du partenaire d'intégration qui gère l'accès à l'API. L'extension ne les fournit pas.
Vous avez décidé des valeurs par défaut de l'entreprise qui influenceront la configuration : devise par défaut, quel texte légal/de consentement le concessionnaire souhaite sur les formulaires de contact, et quelles fonctionnalités (réservation d'essai routier, alertes de recherche, Assistant IA, analyses) doivent être activées au lancement.
Une sauvegarde du site WordPress est en place, et idéalement, la configuration est effectuée sur un environnement de pré-production qui reflète la production.

Ordre de configuration recommandé

Les dix étapes suivantes constituent la séquence recommandée. Chaque étape s'appuie sur la précédente. Ne sautez pas d'étapes — par exemple, n'activez pas les importations automatiques avant que le test de connexion ait réussi.

Activation de la licence
État de préparation du système
Identifiants API
Test de connexion
Réglages d'importation
Réglages de mise en page et du frontend
Réglages juridiques, de confidentialité et de consentement
Importation de test
Validation du frontend
Vérifications de mise en production

Instructions étape par étape

Étape 1 — Activation de la licence

Ouvrez Car Market Hub → Settings et complétez la carte License Activation en haut de la page. Saisissez votre clé de licence et cliquez sur Activate. Une activation réussie déverrouille les zones premium de l'extension ; les onglets d'administration de Car Market Hub autres que Settings cessent d'afficher l'écran « Licence requise », et les importations, le cron et le traitement en arrière-plan deviennent disponibles.

La clé de licence est en écriture seule : elle ne vous est plus jamais affichée après l'enregistrement. La même carte propose également Check license (re-valide la clé stockée) et Remove license (efface la clé tout en conservant vos véhicules importés, vos pages et vos médias). Si vous avez commencé avec l'assistant de première configuration, l'activation de la licence est sa première étape, elle est donc déjà effectuée.

Ne continuez pas tant que la licence n'est pas active. Sans elle, les autres onglets de configuration restent verrouillés.

Étape 2 — État de préparation du système

Ouvrez Car Market Hub → System & Help et examinez les vérifications de l'environnement. La page indique l'état de PHP, JSON, OpenSSL, cURL, GD/Imagick, du dossier des téléversements, de la planification du cron, du cache des jetons, du fichier journal et de la file d'attente des images, avec des badges d'état de type feu tricolore.

Résolvez tous les badges rouges avant de continuer. Les actions typiques consistent à activer une extension PHP manquante, à corriger les permissions sur le dossier des téléversements ou à résoudre un WP-Cron non fonctionnel.

Pour un examen plus approfondi de l'environnement, consultez la Configuration requise pour le système technique et la Configuration requise pour l'API, le réseau et le SSL.

Étape 3 — Identifiants API

Ouvrez Car Market Hub → Settings et complétez la carte API Connection & General Settings :

API Base URL — l'URL HTTPS complète pour votre environnement AutoScout24 ou votre point de terminaison d'intégration, y compris https://.
Seller ID — un ou plusieurs Seller IDs, séparés par des virgules si vous gérez plusieurs comptes de vendeur.
Client ID et Client Secret — les identifiants émis pour votre accès à l'API.
Default currency — la devise utilisée lorsqu'une annonce importée n'en fournit pas.

Cliquez sur Save Settings en bas de la carte.

Un guide complet de chaque champ d'identifiant, de sa provenance et de la manière de le manipuler en toute sécurité est fourni dans la Configuration des identifiants API. Pour en savoir plus sur l'obtention de l'accès à l'API, consultez AutoScout24 API Setup et External API Credentials.

Étape 4 — Test de connexion

Après avoir enregistré les identifiants, validez-les avant toute importation. Ouvrez Car Market Hub → Tools et utilisez la carte API Connection Test. Cliquez sur Test Connection. Un test réussi confirme que l'extension peut s'authentifier auprès du point de terminaison de jeton configuré et atteindre l'API d'annonces AutoScout24 pour le premier Seller ID configuré.

Ne passez pas aux réglages d'importation tant que le test de connexion n'a pas réussi. La procédure complète, y compris la manière d'interpréter le résultat et de réagir aux erreurs courantes, est documentée dans le Test de connexion.

Étape 5 — Réglages d'importation

Une fois que la connexion fonctionne, configurez la manière dont les véhicules sont importés. Les réglages correspondants se trouvent à deux endroits :

Car Market Hub → Settings — options d'image (s'il faut importer les images, nombre maximal d'images par véhicule, conversion WebP optionnelle et qualité), état par défaut des publications et auteur des publications pour les véhicules nouvellement créés, et l'option Default pages qui peut créer les pages Cars, Compare Cars et Favorites lors de l'enregistrement.
Car Market Hub → Import & Limits — comportement de planification et d'exécution : l'intervalle WP-Cron (toutes les heures, toutes les 6 heures, deux fois par jour, tous les jours ou personnalisé), l'heure de début pour les planifications quotidiennes/bi-quotidiennes, le mode Full Sync optionnel (qui supprime les véhicules locaux qui ne sont plus présents sur AutoScout24), et les réglages de robustesse du cron (nombre maximal de véhicules par exécution du cron, activation/désactivation de la file d'attente des images).

Pour la configuration initiale, choisissez des valeurs prudentes :

Laissez la planification automatique désactivée pour le moment. Planifiez-la après une importation de test réussie.
Conservez la file d'attente des images activée afin que les exécutions du cron ne dépassent pas les délais d'expiration de PHP.
Laissez Full Sync désactivé jusqu'à ce que vous ayez vérifié que tous les véhicules attendus arrivent correctement. Full Sync supprime définitivement les publications locales, y compris les images, pour toute annonce non renvoyée par l'API.

Pour le cron externe (au niveau du serveur), y compris le point de terminaison REST sécurisé par jeton, consultez Server Cron Setup.

Étape 6 — Réglages de mise en page et du frontend

Configurez la manière dont les véhicules seront présentés sur le frontend avant de les exposer aux visiteurs :

Car Market Hub → Design & Styles — couleurs, polices, mises en page des archives et des véhicules individuels, mise en page de la galerie, visionneuse (lightbox), badges d'état et texte d'introduction/de pied de page sur les pages d'archives.
Car Market Hub → Layout Manager — activez/désactivez les filtres individuels qui apparaissent sur l'archive des véhicules (marque, modèle, année, prix, kilométrage, carburant, boîte de vitesses, couleur, type de carrosserie et autres).
Car Market Hub → Mapping — contrôlez les libellés lisibles par l'homme et la visibilité de chaque champ de données AutoScout24 sur les pages de détails. Les valeurs par défaut sont judicieuses ; n'ajustez que les libellés ou la visibilité que vous souhaitez réellement modifier.
Car Market Hub → Shortcodes & Widgets — la référence des shortcodes utilisés dans les mises en page personnalisées (par exemple les pages de comparaison et de favoris). Si vous avez activé l'option Default pages dans les réglages, les pages correspondantes existent déjà ; sinon, placez les shortcodes manuellement.

Étape 7 — Réglages juridiques, de confidentialité et de consentement

ADP Car Market Hub traite les données de leads et, en option, les abonnements aux alertes de recherche. Configurez les réglages correspondants avant la mise en production :

Car Market Hub → Leads — configurez l'adresse e-mail du destinataire, les champs visibles du formulaire, la case à cocher de consentement (libellé et caractère obligatoire) et les messages de notification. Le texte de consentement et les champs visibles doivent refléter la politique de confidentialité du concessionnaire.
Car Market Hub → Leads — configurez également les options de réservation d'essai routier (jours de la semaine disponibles, plage horaire quotidienne, durée du créneau, dates d'exclusion) dans cet onglet. Car Market Hub → Search Alerts — si la fonctionnalité d'alertes de recherche est activée dans l'onglet Settings (ou dans l'assistant de configuration), gérez les abonnements ici. Les alertes de recherche utilisent une confirmation par e-mail Double-Opt-In conforme au RGPD ; les modèles d'e-mail pour les notifications au concessionnaire et au client sont configurés respectivement dans l'onglet Search Alerts et dans l'onglet Leads.
Politique de confidentialité du site — le site WordPress doit disposer d'une politique de confidentialité publiée qui couvre les données collectées par l'extension (données du formulaire de contact, événements d'analyse optionnels, abonnements optionnels aux alertes de recherche).

Des informations complémentaires sont disponibles dans Lead Data and Consent, Search Alerts Double Opt-In, GDPR / DSGVO Notes et dans l'Aperçu du stockage des données.

Étape 8 — Importation de test

Effectuez une petite importation contrôlée avant d'activer la planification automatique.

Deux options sûres :

Simulation (Dry run). Ouvrez Car Market Hub → Tools et utilisez la carte Dry Run. Elle récupère un aperçu des annonces pour le(s) Seller ID(s) configuré(s) sans créer de publications de véhicules. Cela permet de valider que les identifiants accèdent à des données réelles sans modifier le site.
Importation manuelle via l'importateur de véhicules. Ouvrez Car Market Hub → Car Importer. Prévisualisez les annonces renvoyées par l'API et déclenchez une importation pour un ou deux véhicules individuels. Cela crée de réelles publications as24ci_car et y associe des images, ce qui constitue le moyen le plus rapide de valider l'ensemble du processus d'importation de bout en bout.

Une fois qu'une petite importation a réussi, lancez une importation manuelle complète via le Batch-Wizard dans Car Market Hub → Import & Limits. Le Batch-Wizard s'exécute par lots adaptatifs avec une barre de progression et peut être mis en pause, repris ou interrompu.

Consultez ensuite l'onglet Logs pour confirmer qu'il n'y a eu ni avertissement ni erreur.

Étape 9 — Validation du frontend

Après l'importation de test, validez le frontend avec des données réelles :

Ouvrez la page d'archive Cars (ou la page où l'archive des véhicules est intégrée). Confirmez que les fiches de véhicules s'affichent correctement, que les images se chargent, que les filtres fonctionnent comme configuré et que la pagination se comporte comme prévu.
Ouvrez au moins une page de véhicule individuel. Confirmez la galerie, le tableau des détails du véhicule, la liste des équipements, le formatage du prix, le formulaire de contact (et la case à cocher de consentement), ainsi que toutes les fonctionnalités optionnelles que vous avez activées (calculateur de financement, formulaire d'essai routier, partage sur les réseaux sociaux).
Soumettez un formulaire de contact de test depuis la page du véhicule individuel. Confirmez que le lead apparaît sous Car Market Hub → Leads et que l'e-mail du destinataire est bien distribué.
Si les alertes de recherche sont activées, effectuez un abonnement de test comprenant l'e-mail de confirmation Double-Opt-In.
Si l'Assistant IA est activé, vérifiez sur au moins un véhicule que la description générée par l'IA (et les autres sorties de l'IA que vous avez activées) est acceptable pour la publication.

Corrigez tout problème — libellés, champs manquants, mise en page — en ajustant l'onglet concerné (Mapping, Design & Styles, Layout Manager, Leads, Settings) et en procédant à une nouvelle validation.

Étape 10 — Vérifications de mise en production

Ce n'est qu'une fois les étapes précédentes terminées que vous devez préparer le site pour la mise en production :

Activez les importations automatiques dans Car Market Hub → Import & Limits avec un intervalle judicieux (pour de nombreux concessionnaires, une planification horaire est appropriée ; les catalogues plus petits peuvent utiliser une planification quotidienne). Sur les hébergeurs qui limitent le WP-Cron, configurez une tâche cron réelle sur le serveur pointant vers le point de terminaison REST sécurisé par jeton de l'extension, comme décrit dans Server Cron Setup.
Décidez s'il convient d'activer Full Sync afin que les annonces supprimées sur AutoScout24 soient également supprimées du site. N'activez cette option qu'après avoir vérifié que tous les véhicules attendus apparaissent systématiquement lors de l'importation.
Exécutez à nouveau le Test de connexion comme ultime vérification de bon fonctionnement.
Parcourez la Liste de contrôle de mise en production pour passer en revue tous les éléments transversaux restants (DNS, mise en cache, visibilité sur les moteurs de recherche, surveillance).

Notes de configuration

La page des réglages n'enregistre que les cartes visibles. La page Settings regroupe les options dans des cartes (API Connection & General Settings, Default Pages & Shortcodes, etc.) ayant chacune leur propre bouton Save. Enregistrez la carte que vous avez modifiée avant de quitter la page.
Pages par défaut. Si l'option Default pages est activée et que les pages correspondantes n'existent pas encore, l'enregistrement des réglages crée automatiquement les pages Cars, Compare Cars et Favorites. Si vous gérez ces pages manuellement, laissez l'option désactivée et placez les shortcodes depuis l'onglet Shortcodes & Widgets.
Devise par défaut. La devise par défaut n'affecte que les importations nouvelles ou mises à jour pour lesquelles l'API ne renvoie aucune valeur de devise. Les publications existantes conservent leur devise stockée.
Mapping vs taxonomies. L'onglet Mapping contrôle uniquement les libellés et la visibilité des champs dans les tableaux de détails. Il ne modifie pas les taxonomies WordPress sous-jacentes qui stockent les valeurs des attributs importés. Renommer un libellé de mapping ne déplace pas les termes de taxonomie existants.
File d'attente des images. Lorsque la file d'attente des images est activée, les importations par cron ne téléchargent que la première image de chaque véhicule de manière synchrone ; les images restantes sont traitées de manière asynchrone par un processus d'arrière-plan. C'est le comportement par défaut recommandé qui évite les dépassements de temps d'exécution PHP sur les grands catalogues.
Full Sync est destructif. Full Sync supprime définitivement les publications locales de véhicules (y compris les images) pour les annonces qui ne sont plus renvoyées par l'API. Traitez cette option comme une fonctionnalité de production et ne l'activez qu'une fois que les importations sont stables.

Notes opérationnelles

Pré-production d'abord, puis production. Toutes les étapes de configuration de ce document doivent d'abord être effectuées sur une copie de pré-production (staging). Une fois que le concessionnaire a validé le comportement sur la pré-production, répliquez la configuration sur la production. N'exportez et n'importez pas l'intégralité de la base de données WordPress entre la pré-production et la production, à moins que vous ne compreniez parfaitement l'impact sur les URL, les options et les identifiants.
Fonctionnement quotidien. Après la configuration, les responsabilités quotidiennes (surveillance des importations, traitement des leads, examen des journaux) sont traitées dans Daily Operation et dans le Manuel de l'utilisateur.
Capacités et délégation. La configuration initiale nécessite un administrateur WordPress complet. Pour les opérations en cours, l'extension fournit un rôle et une capacité délégués afin que les utilisateurs quotidiens n'aient pas besoin des droits d'administration complets de WordPress. Voir Access Control and Capabilities.
Journalisation. Tous les appels API, les demandes de jetons, les actions d'importation et les erreurs sont enregistrés dans les fichiers journaux de l'extension dans wp-content/uploads/as24ci-logs/ avec rotation. La journalisation détaillée ajoute des détails par véhicule et par image et ne doit être activée que temporairement pour le dépannage.

Dépannage

Symptôme	Cause probable	Ce qu'il faut vérifier
System & Help affiche des badges rouges immédiatement après l'activation.	L'environnement d'hébergement ne répond pas aux exigences de l'extension (extension PHP manquante, dossier d'importation non accessible en écriture, WP-Cron défaillant).	Résolvez chaque badge rouge avec votre hébergeur avant de continuer. Voir la Configuration requise pour le système technique.
La page des réglages n'enregistre pas les identifiants, ou les champs apparaissent vides après l'enregistrement.	Formulaire soumis depuis la mauvaise carte, page mise en cache par le navigateur ou extension de sécurité bloquant la requête.	Enregistrez la bonne carte. Rechargez la page. Désactivez temporairement les autres extensions qui filtrent les requêtes `POST`.
Le test de connexion échoue.	Mauvaise URL de base de l'API, mauvais identifiants, HTTPS sortant bloqué, problèmes de SSL/pare-feu.	Suivez le Connection Test et API Connection Errors.
L'importation de test importe zéro véhicule.	Le Seller ID configuré n'a pas d'annonces, les identifiants s'authentifient sur un autre compte, ou l'API a renvoyé un résultat vide.	Vérifiez à nouveau le Seller ID avec le compte AutoScout24 du concessionnaire ; confirmez via le Dry Run dans Tools.
Les pages de véhicules s'affichent sans images, ou les images apparaissent plus tard.	La file d'attente d'images est activée (comportement attendu) et le processus en arrière-plan n'a pas encore traité la file d'attente, ou des délais d'attente PHP (timeouts) interrompent les téléchargements.	Utilisez le statut de la file d'attente d'images dans System & Help ; déclenchez Run image queue now. Voir Image Import Errors.
Les importations Cron ne s'exécutent pas automatiquement après l'activation de la planification.	WP-Cron est désactivé ou limité par l'hébergeur.	Configurez un cron de serveur externe pointant vers le point de terminaison REST de l'extension. Voir la Configuration du cron du serveur et Cron Errors.
Les e-mails de leads ne sont pas reçus.	Le site ne peut pas envoyer d'e-mails, ou l'adresse du destinataire est incorrecte.	Vérifiez l'e-mail du destinataire sous Leads et la configuration de messagerie sortante du site. Voir Email and Lead Errors.