Documentation · Dépannage

Aperçu du dépannage

Ce document fournit un point d'entrée structuré pour diagnostiquer et résoudre les problèmes liés à l'extension ADP Car Market Hub WordPress. Il décrit l'ordre de diagnostic recommandé, l'emplacement des journaux et des informations d'état, ainsi que les bonnes pratiques de sécurité lors de l'intervention du support.

Quand utiliser ce document

Lisez ce document en premier dès que l'extension ne se comporte pas comme prévu. Il vous guidera vers la page spécialisée appropriée et vous aidera à collecter les informations nécessaires avant de contacter le support.

Aperçu

L'extension ADP Car Market Hub se connecte à l'API AutoScout24, importe les annonces de véhicules dans WordPress, gère l'automatisation planifiée et affiche les annonces sur le frontend. Des problèmes peuvent survenir à n'importe lequel de ces niveaux. Commencer par un ordre de diagnostic systématique vous évite de perdre du temps sur le mauvais niveau.

Ordre de diagnostic recommandé

Traitez chaque niveau dans l'ordre. Arrêtez-vous et consultez le document spécialisé concerné dès que vous identifiez la zone problématique.

  1. Vérifier le journal de l'extension – L'extension écrit tous les événements importants, les erreurs et les résultats d'importation dans un fichier journal dédié. C'est toujours le premier endroit où regarder.
  2. Vérifier la connexion API – Si le journal affiche des erreurs d'authentification ou HTTP, ou si la page d'état du système signale un problème de connexion, consultez Erreurs de connexion API.
  3. Vérifier les résultats d'importation – Si des véhicules sont manquants, partiellement importés ou affichent des données obsolètes, consultez Erreurs d'importation.
  4. Vérifier l'automatisation planifiée – Si les importations automatiques ne s'exécutent pas ou si l'heure de la dernière exécution n'avance pas, consultez Erreurs de Cron.
  5. Vérifier les importations d'images – Si des images de véhicules sont manquantes ou ne sont pas entièrement téléchargées, consultez Erreurs d'importation d'images.
  6. Vérifier l'affichage frontend – Si les annonces apparaissent dans le back-office mais pas correctement sur le frontend, consultez Problèmes d'affichage frontend.
  7. Vérifier les permissions – Si les écrans d'administration ou les actions d'importation renvoient des erreurs d'accès refusé, consultez Erreurs de permission.

Où trouver les journaux et les informations d'état

Fichier journal de l'extension

L'extension écrit dans un fichier journal situé dans le dossier des téléversements de WordPress :

wp-content/uploads/as24ci-logs/adp-car-market-hub.log

Le répertoire des journaux est protégé contre l'accès web direct par un fichier .htaccess et une barrière index.php. Accédez au fichier via SFTP, le gestionnaire de fichiers de l'hébergement ou un outil de visualisation de journaux avec accès au serveur.

Le fichier journal effectue une rotation automatique lorsqu'il dépasse 10 Mo. Les archives issues de la rotation sont nommées adp-car-market-hub-YYYYMMDD-HHMMSS.log et sont supprimées automatiquement après 7 jours.

La journalisation détaillée (entrées par véhicule et par image) est activée par défaut. Vous pouvez la désactiver dans les réglages de l'extension pour réduire le volume des journaux sur les grands catalogues.

Page d'état du système

L'administration de l'extension comprend un onglet Système et aide qui affiche :

  • L'état de la connexion API (testé pour la dernière fois avec le Seller ID configuré)
  • L'heure de la dernière exécution d'importation et le décompte des résultats (insérés, mis à jour, ignorés, erreurs)
  • L'état de WP-Cron ou du cron du serveur et l'heure de la dernière exécution
  • L'état de la file d'attente des images (éléments en attente, dernière exécution du processus en arrière-plan)

Consultez cette page avant de vérifier les journaux bruts.

Administration de WordPress

Les outils standards de WordPress fournissent également des informations utiles :

  • Outils → Actions planifiées (ou une extension de visualisation WP-Cron) : vérifiez que les événements as24ci_scheduled_import et as24ci_image_queue_process sont présents et ont une heure de prochaine exécution cohérente.
  • Médiathèque : confirmez que les images des véhicules sont bien associées aux publications correspondantes.
  • Articles → Voitures : vérifiez le nombre de publications de véhicules publiées ainsi que les brouillons ou les entrées en attente.

Prérequis pour un dépannage efficace

Avant de commencer vos recherches, confirmez les points suivants :

  • Vous disposez d'un accès administrateur au tableau de bord WordPress.
  • Vous disposez d'un accès au serveur (SFTP, SSH ou gestionnaire de fichiers de l'hébergement) pour lire le fichier journal.
  • Vous connaissez la version de l'extension actuellement installée (visible dans Extensions → Extensions installées).
  • Vous connaissez la version de PHP et la version de WordPress du site (visibles dans Outils → Santé du site).

Bonnes pratiques de sécurité lors de l'intervention du support

  • Ne partagez pas vos identifiants API (Client ID, Client Secret ou jetons d'accès) dans les tickets de support ou les forums publics. Le journal de l'extension masque automatiquement ces valeurs.
  • Fournissez uniquement la section pertinente du fichier journal (pas le fichier entier, sauf demande contraire).
  • Incluez la capture d'écran ou le contenu textuel de la page d'état du système.
  • Décrivez les étapes exactes que vous avez effectuées avant l'apparition du problème, y compris les modifications récentes de réglages ou les mises à jour d'extensions.
  • Si vous soupçonnez un problème lié à WordPress ou à l'environnement d'hébergement, incluez les informations de Outils → Santé du site → Informations.

Notes opérationnelles

  • La plupart des problèmes sont causés par des identifiants incorrects, un point de terminaison d'API inaccessible ou une planification cron désactivée ou mal configurée.
  • L'extension utilise des verrous transitoires WordPress pour empêcher les exécutions d'importation de se chevaucher. Si une importation a été interrompue anormalement, le verrou peut persister jusqu'à 40 minutes avant d'être automatiquement libéré.
  • L'extension stocke le résultat de la dernière importation (décomptes et horodatage) dans les options de WordPress. Ceux-ci sont visibles sur le tableau de bord d'administration et sont également écrits dans le journal.

Documents connexes