Référence des outils

Ce document est une référence pour l'écran Outils de l'extension ADP Car Market Hub (Car Market Hub → Tools). Il couvre les exports, la gestion du cache, la synchronisation des taxonomies, le test de connexion API, les données de démonstration et le centre de diagnostics.

Quand utiliser ce document

Lisez ceci si vous devez :

• Exporter les données des véhicules importés pour sauvegarde, audit ou migration.
• Forcer l'extension à récupérer de nouvelles données fraîches depuis l'API AutoScout24.
• Réassocier les termes de taxonomie (marque, modèle, carburant, couleur...) aux véhicules importés.
• Vérifier que les identifiants API fonctionnent.
• Installer ou supprimer des données de démonstration pour une démonstration commerciale ou un environnement de pré-production.
• Exécuter des diagnostics ciblés sur une publication de véhicule spécifique ou générer un instantané du système pour le support.

Aperçu

L'écran Outils est la boîte à outils opérationnelle pour les administrateurs. Il regroupe les actions de maintenance dans des cartes indépendantes afin qu'elles puissent être déclenchées sans quitter la page :

• Assistant de configuration — ouvre l'assistant facultatif en six étapes Première configuration. Disponible à tout moment, même après que l'assistant a été complété ou ignoré. Le réexécuter vous permet de reconfigurer le mode de configuration, le profil du concessionnaire, la connexion AutoScout24, les pages par défaut et les fonctionnalités par défaut du frontend ; les réglages existants sont préservés à moins que vous ne les modifiiez explicitement.
• Exporter les véhicules — téléchargement CSV ou JSON des données des véhicules importés. Cette carte n'apparaît que lorsque la fonctionnalité d'exportation est activée ; elle peut être masquée.
• Nettoyeur de cache — vide le cache des jetons OAuth2 et le cache des modèles.
• Synchro des taxonomies — réapplique les termes de taxonomie à partir des valeurs stockées pour chaque véhicule importé.
• Test de connexion API — effectue une requête en direct vers AutoScout24 avec les identifiants actuels.
• Données de démonstration — installe ou supprime un ensemble balisé de véhicules, leads, alertes et analyses de démonstration.
• Centre de diagnostics — diagnostics pour une publication unique, aperçu de simulation (dry run) et instantané système au format JSON.

Configuration requise ou prérequis

• Un utilisateur disposant de la capacité de gestion de l'extension.
• Pour que le test de connexion API et le nettoyeur de cache soient utiles : des identifiants API valides configurés dans les Réglages.
• Pour les diagnostics sur une publication unique : l'ID de publication WordPress d'un véhicule importé.

Instructions étape par étape

Exporter les véhicules importés

1. Ouvrez Car Market Hub → Tools.
2. Dans la carte Exporter les véhicules, cliquez sur Exporter en CSV pour les flux de travail sur tableur, ou sur Exporter en JSON pour les données structurées et l'utilisation par les développeurs.

Vider les caches

1. Dans la carte Nettoyeur de cache, cliquez sur : - Vider le cache des jetons — supprime le jeton d'accès OAuth2 mis en cache. La prochaine requête API récupérera un nouveau jeton. - Vider le cache des modèles — supprime les données de correspondance véhicule-modèle mises en cache afin qu'elles soient reconstruites à la demande.
2. La ligne d'état indique si un jeton est actuellement mis en cache.

À utiliser après des modifications d'identifiants, après avoir changé d'environnement API, ou lorsque des données API fraîches sont requises.

Synchroniser les taxonomies

1. Dans la carte Synchro des taxonomies, cliquez sur Lancer la synchro des taxonomies.
2. L'extension parcourt toutes les publications de véhicules importés et réapplique les relations de termes de taxonomie (marque, modèle, carburant, couleur et autres attributs du véhicule) à partir des valeurs stockées dans la table des véhicules.
3. Le nombre de publications traitées est affiché après l'exécution.

À utiliser lorsque des termes de filtre semblent manquants, obsolètes ou désynchronisés (par exemple après une migration de base de données ou une réactivation de l'extension).

Tester la connexion API

1. Dans la carte Test de connexion API, cliquez sur le bouton de test.
2. L'extension émet une requête en direct vers l'API AutoScout24 avec les identifiants actuels et signale le résultat.

Exécutez ceci après avoir mis à jour les identifiants ou lorsque les importations commencent à échouer de manière inattendue.

Installer ou supprimer des données de démonstration

1. Dans la carte Données de démonstration, cliquez sur Installer les données de démonstration.
2. L'extension installe 10 véhicules de démonstration : 8 sont publiés immédiatement, et 2 apparaissent comme des annonces non encore importées sur la page de l'Importateur de véhicules afin que vous puissiez tester le flux de travail d'importation. Elle crée également des exemples de leads et d'alertes de recherche, ainsi que des analyses synthétiques couvrant 30 jours.
3. Pour annuler, cliquez sur Supprimer les données de démonstration. Seuls les enregistrements créés par l'installateur de démonstration sont supprimés ; les données réelles des clients ne sont pas affectées.

La carte affiche un résumé en direct des éléments actuellement installés (véhicules importés, annonces de l'importateur en attente, leads, alertes et événements d'analyse) ou Aucune donnée de démonstration installée lorsque rien n'est présent. Après avoir installé ou supprimé des données de démonstration, un dernier panneau de résumé d'installation/suppression signale ce qui a été créé ou nettoyé.

À utiliser pour les démonstrations de produits, l'examen interne et les tests frontend sans connexion AutoScout24 en direct.

Diagnostiquer une publication de véhicule unique

1. Dans le Centre de diagnostics, localisez Diagnostiquer une publication de véhicule.
2. Saisissez l'ID de publication WordPress d'un véhicule importé et validez.
3. L'extension renvoie les métadonnées de la publication, les références d'images, la charge utile brute AutoScout24 (si présente) et les réponses API en direct pour les points de terminaison de l'annonce et des équipements.

Exécuter une simulation (dry run)

1. Dans le Centre de diagnostics, localisez Simulation (dry run).
2. Validez. L'extension prévisualise les données qu'elle importerait depuis AutoScout24 sans écrire de modifications dans la base de données. L'aperçu est limité à environ 25 lignes et s'affiche sous forme d'aperçu JSON.

À utiliser pour vérifier la structure des données API avant une importation complète.

Partager un instantané du système

1. Dans le Centre de diagnostics, développez Afficher l'instantané du système.
2. Copiez le contenu JSON et joignez-le à un ticket de support ou partagez-le avec votre équipe opérationnelle.

L'instantané comprend la version de l'extension, l'URL du site, les versions de WordPress et de PHP, le nom du thème, l'état des journaux et une vue masquée des réglages clés de l'extension (uniquement des indicateurs tels que Client ID défini : oui/non ; les secrets bruts ne sont pas exportés).

Référence de configuration

L'écran Outils ne stocke pas ses propres réglages. Il s'agit d'un lanceur pour des opérations ponctuelles.

Notes opérationnelles

• Toutes les actions de cet écran sont des opérations directes et ponctuelles. Il n'y a pas de planification ici.
• L'indicateur d'état du cache des jetons (Cache des jetons actif / Aucun cache de jeton) reflète le jeton OAuth2 actuellement stocké dans le stockage transitoire de WordPress.
• Les données de démonstration sont identifiées par une balise interne afin que leur suppression soit sûre et ne touche pas aux enregistrements réels des clients. Vérifiez ce comportement dans la version actuelle de l'extension avant de publier si vous opérez sur un site de production.
• Les exportations peuvent être volumineuses selon le nombre de véhicules importés. Le CSV est généré sous forme de flux ; le JSON est généré en mémoire.
• La recherche de diagnostic de publication effectue un appel API en direct vers AutoScout24 pour les points de terminaison de l'annonce et des équipements. La section des résultats affiche toute erreur renvoyée par l'API.
• L'instantané du système omet intentionnellement les secrets bruts. Traitez-le comme une information de faible sensibilité mais toujours interne.

Dépannage

• Le téléchargement de l'exportation est vide. Aucun véhicule n'est encore importé, ou une autre extension intercepte les requêtes admin-post.php. Confirmez que l'importateur s'est exécuté avec succès sur la Référence de l'importateur de véhicules.
• La synchro des taxonomies signale zéro publication traitée. Aucune publication de véhicule n'existe encore. Lancez d'abord une importation.
• Le test de connexion API signale un échec. Vérifiez à nouveau le Client ID, le Client Secret et l'URL de base dans les Réglages, puis cliquez sur Vider le cache des jetons et réessayez.
• Le diagnostic renvoie "Métadonnées listingid ou sellerid manquantes sur cette publication." La publication n'est pas un véhicule importé, ou la publication est antérieure à la structure actuelle de stockage des véhicules. Réimportez le véhicule.
• Les données de démonstration ne s'installent pas. Confirmez que l'utilisateur dispose de la capacité de gestion et que la base de données peut écrire les enregistrements de démonstration. Consultez les Journaux pour plus de détails.
• L'instantané du système affiche client_id_set: no. Les identifiants ne sont pas stockés. Enregistrez-les dans les Réglages avant de tester.

Documents connexes

• Référence des réglages
• Référence de l'importateur de véhicules
• Référence des importations et des limites
• Référence des journaux
• Référence du système et de l'aide
• Référence du support