Documentation · Dépannage
FAQ de dépannage
Ce document répond aux questions de dépannage les plus fréquemment posées pour l'extension ADP Car Market Hub. Pour des guides détaillés étape par étape, suivez les liens vers les documents de dépannage correspondants.
Général
Le menu de l'extension est absent de l'administration WordPress après l'activation.
L'administration de l'extension est uniquement accessible aux utilisateurs WordPress disposant de la fonctionnalité manage_as24_imports, qui est attribuée au rôle administrator lors de l'activation. Connectez-vous en tant qu'administrateur WordPress. Si le menu est toujours manquant, désactivez et réactivez l'extension pour réexécuter l'attribution des fonctionnalités. Voir Permission Errors.
Je peux voir l'administration de l'extension mais tous les boutons renvoient "Permission denied".
Toutes les actions AJAX et les soumissions de formulaires de l'extension vérifient la fonctionnalité manage_as24_imports. Si le statut d'administrateur a été accordé à votre compte utilisateur après l'activation de l'extension, il se peut que la fonctionnalité ne lui ait pas été attribuée. Désactivez et réactivez l'extension, ou demandez à un super-administrateur de vérifier votre rôle. Voir Permission Errors.
Comment puis-je vérifier ce que fait l'extension ?
Ouvrez l'onglet Logs dans l'administration de l'extension. Le journal enregistre toutes les exécutions d'importation, les erreurs, les téléchargements d'images et les événements système. Pour un export de diagnostic téléchargeable (JSON ou ZIP), utilisez l'onglet System & Help. Voir Cron Errors et Import Errors.
Licence
Une fonctionnalité affiche "not active for this license" ou un onglet entier est remplacé par un écran de verrouillage.
Plusieurs fonctionnalités (Market Insights, l'AI Assistant et le Content Studio, entre autres) sont régies par la licence de votre extension ADP Car Market Hub. Lorsque la licence n'inclut pas une fonctionnalité, celle-ci affiche une notification conviviale "not included in this license" et ses actions ne sont pas exécutées. Lorsque la licence elle-même n'est pas opérationnelle (par exemple expirée ou non vérifiée), les actions opérationnelles telles que les importations sont suspendues et les zones d'administration concernées affichent un écran de verrouillage de licence. Les pages et données de véhicules existantes ne sont supprimées dans aucun des deux cas. Contactez le support ADP Car Market Hub pour activer une fonctionnalité ou pour restaurer une licence expirée ou suspendue. Voir Market Insights Issues.
Les importations ont cessé de s'exécuter et le journal mentionne la licence.
Lorsque la licence est expirée, suspendue ou ne peut pas être vérifiée au-delà de la période de grâce, les actions opérationnelles telles que les importations et l'analyse quotidienne des prix sont suspendues (elles s'arrêtent par sécurité). Aucun article, méta ou média n'est supprimé en conséquence. Restaurez ou renouvelez la licence pour reprendre le fonctionnement normal.
Assistant de configuration
La notification de configuration "Welcome to ADP Car Market Hub" n'apparaît pas.
La notification ne s'affiche que lorsqu'un horodatage de première activation a été enregistré et que l'assistant n'a pas été complété ou ignoré, et l'utilisateur actuel doit disposer de la fonctionnalité de gestion de l'extension. Les mises à niveau de l'extension qui ne déclenchent pas une nouvelle activation n'affichent pas la notification sur les installations existantes. Vous pouvez toujours ouvrir l'assistant manuellement depuis Car Market Hub → Tools → Setup Wizard ou depuis le lien Run Setup Wizard sur le Tableau de bord. Voir Setup Wizard Reference.
J'ai ignoré l'assistant. Comment puis-je l'ouvrir à nouveau ?
Ouvrez Car Market Hub → Tools et cliquez sur la carte Setup Wizard, ou utilisez le lien Run Setup Wizard situé près du haut de Car Market Hub → Dashboard. L'assistant reste accessible à l'adresse wp-admin/admin.php?page=as24ci-setup-wizard même après avoir été ignoré ou complété.
L'assistant n'a pas créé mes pages.
Soit l'option Skip a été sélectionnée pour cette page à l'étape 4, soit une page existante avec le même titre a été réutilisée (l'assistant élimine les doublons par titre pour éviter de créer des doublons), soit l'option correspondante (as24ci_page_archive_id, as24ci_page_compare_id, as24ci_page_favorites_id) pointait déjà vers une page publiée. Ouvrez la liste WordPress Pages pour confirmer. L'assistant ne supprime jamais les pages existantes.
Le champ Client Secret est vide lorsque je rouvre l'étape 3.
C'est par conception. Le Client Secret stocké n'est jamais restitué dans le HTML d'administration, que ce soit dans l'assistant ou dans l'onglet Settings. Soumettre le formulaire en laissant le champ vide préserve le secret stocké existant. Soumettre une valeur non vide le remplace.
L'analyse n'est pas activée après une configuration en production (Live).
En mode Live, la case d'activation de l'analyse est décochée par défaut et doit être activée explicitement. Rouvrez l'assistant et cochez la case de l'analyse à l'étape 5, ou activez l'analyse dans l'onglet Analytics. Confirmez d'abord le consentement aux cookies et les exigences de confidentialité. Voir Analytics Retention.
Les données de démonstration n'ont pas été installées.
Les données de démonstration ne sont installées que lorsque Demo setup est sélectionné à l'étape 1 et que l'assistant est terminé avec Install Demo Data and Finish à l'étape 6. La configuration Live n'installe pas de données de démonstration. Les données de démonstration peuvent également être installées à tout moment à partir de la carte Demo Data sur Car Market Hub → Tools.
Les pages Comparer ou Favoris sont vides après une installation de démonstration.
Les fonctionnalités Comparer et Favoris sont des fonctionnalités côté client qui lisent depuis le localStorage du navigateur du visiteur. L'installateur de démonstration fournit une solution de repli qui alimente le localStorage lors du premier chargement de la page. Ouvrez la page Cars, Compare ou Favorites une fois dans la même session de navigateur pour déclencher l'alimentation des données.
L'assistant va-t-il écraser mes réglages existants si je l'exécute à nouveau ?
Non. L'assistant écrit uniquement les options dont l'administrateur soumet réellement les champs de formulaire. Le réexécuter partiellement n'efface jamais un réglage qui ne figurait pas sur le formulaire soumis. Le Client Secret est préservé lorsque le champ est laissé vide. L'activation et la réactivation de l'extension sont également non destructives.
API et connexion
Le test de connexion échoue avec "Missing API credentials".
L'URL de base de l'API, le Client ID ou le Client Secret est vide ou incorrect. Ouvrez l'onglet Settings de l'extension, confirmez que les trois champs sont remplis et enregistrez. Voir API Connection Errors.
Le jeton d'accès expire constamment et les importations échouent.
L'extension met en cache le jeton d'accès dans l'option transitoire as24ci_access_token. Si le point de terminaison du jeton renvoie une valeur expires_in très courte, le jeton peut expirer avant la fin de l'importation. Supprimez l'option transitoire via WP-CLI (wp transient delete as24ci_access_token) et réessayez. Si le problème persiste, contactez votre fournisseur d'API pour confirmer la période de validité du jeton. Voir API Connection Errors.
L'importation renvoie zéro véhicule alors que mon compte AutoScout24 contient des annonces.
Les causes les plus courantes sont : le Seller ID est incorrect, les annonces ne sont pas actives ou en ligne sur AutoScout24, ou les identifiants API n'ont pas accès au Seller ID configuré. Vérifiez les quatre paramètres (Base URL, Client ID, Client Secret, Seller ID) et consultez le journal de l'extension pour obtenir des messages d'erreur spécifiques. Voir API Connection Errors et Import Errors.
Importation
Les véhicules sont importés en tant que brouillons au lieu d'être publiés automatiquement.
L'état par défaut des publications est configurable. Ouvrez l'onglet Importer ou Settings de l'extension et vérifiez le réglage Default Post Status. Remplacez-le de draft à publish si vous souhaitez que les véhicules apparaissent sur le site immédiatement après l'importation. Notez que l'importation en tant que draft est la valeur par défaut prudente sur les nouvelles installations. Voir Import Errors.
Certains champs de véhicule sont vides après l'importation.
L'importation mappe les champs de réponse de l'API aux métadonnées de publication WordPress en utilisant la configuration de mapping des champs de l'extension. Si un champ est vide, soit l'annonce AutoScout24 ne contient pas de valeur pour ce champ, soit le mapping des champs a été modifié. Vérifiez l'onglet Field Mapping dans l'administration de l'extension et assurez-vous que les champs concernés sont correctement mappés. Voir Import Errors.
L'importation automatique ne s'exécute pas.
Les importations automatiques nécessitent que l'option Auto Import soit activée et que WP-Cron fonctionne. Ouvrez l'onglet Import & Limits → Automation pour confirmer que l'importation automatique est activée et qu'une planification est configurée. Vérifiez ensuite l'onglet System & Help pour confirmer que l'événement as24ci_scheduled_import est planifié. Si DISABLE_WP_CRON est défini sur true dans wp-config.php, WP-Cron ne se déclenchera pas et un déclencheur cron externe devra être configuré. Voir Cron Errors.
Images
Les véhicules sont importés mais n'ont pas d'images.
L'importation d'images est contrôlée par l'option Import Images dans les réglages de l'importateur. Confirmez qu'elle est activée. Si elle est activée mais que les images sont toujours manquantes, ouvrez le journal de l'extension et recherchez Image download failed ou media_handle_sideload failed pour identifier l'erreur spécifique. Les causes courantes incluent un espace disque insuffisant, des autorisations d'écriture manquantes sur wp-content/uploads et les limites de mémoire PHP. Voir Image Import Errors.
Certaines images sont manquantes alors que d'autres ont été importées avec succès.
L'extension traite les images via une file d'attente en arrière-plan (le gestionnaire de file d'attente d'images). Les images qui n'ont pas pu être téléchargées lors de l'exécution principale de l'importation sont retentées de manière asynchrone. Vérifiez l'onglet System & Help pour connaître la taille de la file d'attente d'images et l'heure de la dernière exécution. Vous pouvez également déclencher la file d'attente manuellement à l'aide du bouton Run Image Queue. Voir Image Import Errors.
Les images WebP converties ne sont pas générées.
La conversion WebP nécessite soit l'extension GD avec le support imagewebp, soit l'extension Imagick. Confirmez que l'une d'elles est disponible sur votre serveur (vérifiez Outils → Santé du site → Informations → Serveur dans WordPress). La conversion WebP est désactivée par défaut. Activez-la dans les réglages de l'importateur lorsque votre serveur la prend en charge. Voir Image Import Errors.
Affichage sur le site (Frontend)
La page d'archive des véhicules affiche une erreur 404.
La cause la plus courante est que les règles de réécriture des permaliens de WordPress doivent être régénérées. Allez dans Réglages → Permaliens et cliquez sur Enregistrer les modifications sans apporter de modifications. Cela régénère les règles de réécriture. Voir Frontend Display Issues.
La page de liste des véhicules n'affiche aucun véhicule alors que des véhicules sont importés.
Les véhicules doivent avoir l'état publish pour apparaître sur l'archive. Vérifiez si les véhicules sont à l'état de brouillon et publiez-les. Confirmez également qu'aucun filtre actif ou requête de recherche ne masque les résultats, et qu'aucun plugin de mise en cache ne sert une page obsolète. Voir Frontend Display Issues.
Les pages d'archive ou de détail des véhicules semblent cassées ou sans style.
L'extension charge son CSS et son JavaScript uniquement sur les pages où un shortcode de véhicule est présent dans post_content, ou sur les modèles d'archive et de publication unique standard du CPT. Si votre thème utilise un constructeur de page ou un modèle personnalisé qui ne génère pas directement post_content, les ressources peuvent ne pas se charger. Ajoutez le shortcode [as24ci_archive] directement dans le champ de contenu de la page. Voir Frontend Display Issues et Shortcode Issues.
Shortcodes
Un shortcode s'affiche en texte brut sur la page.
Le traitement des shortcodes est désactivé dans certains contextes (par exemple, les constructeurs de pages, les zones de widgets ou les fichiers de modèles personnalisés qui n'appellent pas do_shortcode). Vérifiez que le shortcode est placé dans le champ standard Contenu de WordPress d'une page ou d'un article, et non dans un widget, un champ personnalisé ou un modèle PHP. Voir Shortcode Issues.
Le shortcode [as24ci_archive] ne produit rien.
Si le shortcode est à la bonne position mais ne produit rien, la cause la plus probable est qu'aucun véhicule publié n'existe. Vérifiez que les véhicules sont importés et publiés. Confirmez également que les valeurs des attributs du shortcode sont valides — par exemple, per_page doit être un entier positif. Voir Shortcode Issues.
E-mails et Leads
Aucun e-mail n'arrive lorsqu'un visiteur soumet un formulaire de demande.
L'extension envoie des e-mails de notification en utilisant wp_mail(). Si aucun e-mail n'arrive, vérifiez si votre site WordPress est correctement configuré pour la distribution d'e-mails. De nombreux environnements d'hébergement nécessitent une extension SMTP pour envoyer des e-mails de manière fiable. Vérifiez également que l'adresse du destinataire configurée dans les réglages de l'extension est correcte et qu'elle n'est pas filtrée par un dossier de spam. Voir Erreurs d'e-mail et de lead.
Le lead est enregistré dans l'administration des Leads mais aucune notification par e-mail n'est envoyée.
Les données du lead sont enregistrées dans le type de contenu personnalisé as24ci_lead, indépendamment de la distribution de l'e-mail. L'envoi de l'e-mail est un processus distinct. Vérifiez la configuration de l'adresse du destinataire (réglage de surcharge globale → e-mail du profil du vendeur → e-mail de l'auteur de la publication → e-mail de secours de l'administrateur WordPress) et testez avec une extension d'envoi SMTP simple. Voir Erreurs d'e-mail et de lead.
Le formulaire de contact renvoie une erreur de validation alors que tous les champs semblent être remplis.
Le formulaire valide le nom, l'adresse e-mail, le message et la case à cocher de consentement côté serveur. Un champ anti-spam honeypot doit également être vide. Si l'erreur persiste, il se peut qu'une saisie automatique du navigateur ait rempli le champ honeypot, ou qu'un conflit JavaScript interfère avec le formulaire. Essayez de soumettre le formulaire dans une fenêtre de navigation privée sans aucune extension active. Voir Erreurs d'e-mail et de lead.
Market Insights
Tous les véhicules affichent no_data dans la colonne Market Score.
Le statut no_data est renvoyé lorsqu'un véhicule n'a pas de prix enregistré (_as24ci_price est vide ou égal à zéro). Vérifiez que les véhicules ont été importés avec un prix. Si c'est le cas, relancez l'importation ou déclenchez manuellement l'analyse des prix en désactivant puis en réactivant l'extension. Voir Problèmes de Market Insights.
Le nombre de jours sur le parc (Days on Lot) affiche 0 ou un nombre anormalement élevé.
Une valeur de 0 peut signifier que le véhicule a été publié aujourd'hui ou qu'il fait l'objet d'une publication planifiée à une date future. Des valeurs très élevées indiquent une date de publication corrompue (par exemple, importée à partir d'un enregistrement avec une date à zéro). Vérifiez la date de publication du véhicule dans le tableau de la liste des publications. Voir Problèmes de Market Insights.
PDF Datasheet
L'URL de la fiche technique (?as24ci_pdf=123) renvoie une erreur 404.
Soit la fonctionnalité PDF Datasheet n'est pas activée, soit l'ID de la publication est incorrect, soit le véhicule n'est pas dans le statut publish. Activez la fonctionnalité dans les réglages de l'extension, videz les permaliens et confirmez que le véhicule est publié. Voir Problèmes de PDF Datasheet.
La fiche technique n'affiche aucune image.
Confirmez que des images ont été importées pour le véhicule et que l'option Show Gallery est activée dans les réglages du PDF Manager. La fiche technique affiche un maximum de 5 images. Voir Problèmes de PDF Datasheet.