Documentation · Référence de l'administrateur

Référence du système et de l'aide

Ce document est une référence pour l'écran Système et aide de l'extension ADP Car Market Hub (Car Market Hub → System & Help). Il explique les panneaux de connectivité, de tâches en arrière-plan, de serveur, de fichiers journaux et de file d'attente d'images présentés par cette vue d'état de santé.

Quand utiliser ce document

Lisez ceci si vous devez :

Confirmer que l'API AutoScout24, le point de terminaison REST de l'extension et l'API Market Hub sont accessibles.
Vérifier si les tâches planifiées (tâches cron) sont saines et quand elles s'exécuteront la prochaine fois.
Déclencher une importation, une exécution de la file d'attente d'images ou une purge de la file d'attente depuis un seul endroit.
Vérifier que le serveur répond aux exigences de l'extension (version PHP, mémoire, temps d'exécution).
Inspecter la taille et l'état de rotation du fichier journal, ainsi que la santé de la file d'attente d'importation d'images.

Aperçu

Cet écran est un tableau de bord d'état de santé principalement en lecture seule. Une barre d'action supérieure au-dessus des cartes comprend un bouton Télécharger les diagnostics — étiqueté Télécharger le ZIP de diagnostic, ou Télécharger le JSON de diagnostic lorsque le support ZIP n'est pas disponible sur le serveur — qui télécharge un package de diagnostic que vous pouvez joindre à une demande de support.

L'écran est divisé en cartes suivantes :

Connectivité et API — État de l'API AutoScout24, état du jeton OAuth2, vérification du point de terminaison REST de l'extension et état de l'API Market Hub.
Diagnostics des mises à jour privées — diagnostics de mise à jour et de version avec un rapport JSON copiable.
Tâches en arrière-plan — liste des événements cron planifiés avec leur planification et leur heure de prochaine exécution, plus des boutons d'action.
Exigences de l'extension — versions minimales et drapeaux de fonctionnalités.
Serveur et stockage — configuration PHP, environnement serveur et intégrité du répertoire des téléversements.
État du fichier journal — taille actuelle du fichier journal, état de rotation et chemin d'accès.
État de la file d'attente d'images — images en attente, statistiques de la dernière exécution du worker.

Chaque ligne utilise des badges de couleur de type feu tricolore (ok, warn, bad) avec des info-bulles qui expliquent le seuil ou l'étape de résolution.

Exigences ou prérequis

Un utilisateur disposant de la capacité de gestion de l'extension.
Pour les vérifications de connectivité : un accès HTTPS sortant depuis le serveur web vers les points de terminaison de l'API configurés.
Pour la vérification de l'API REST : les permaliens personnalisés de WordPress doivent être activés.
Pour la section cron : le cron intégré de WordPress doit être actif, ou un planificateur côté serveur doit appeler wp-cron.php.

Instructions étape par étape

Vérifier la connectivité

Ouvrez Car Market Hub → System & Help.
Dans Connectivité et API, vérifiez : - État du point de terminaison de l'API AS24 et Accessibilité de l'API AS24 pour l'URL de base AutoScout24. - État du jeton (Valide / Expire bientôt / Expiré / Aucun jeton). - État de l'API REST pour le point de terminaison as24ci/v1/cron-import de l'extension. - Accessibilité de Market Hub pour l'API Market Hub.
Survolez n'importe quel badge pour afficher l'info-bulle contenant les détails sous-jacents (statut HTTP, latence ou message d'erreur).

Examiner les diagnostics de mise à jour

Ouvrez la carte Diagnostics des mises à jour privées dans la colonne de droite.
Lisez les lignes pour confirmer que le canal de mise à jour de l'extension est sain : la version installée, si les crochets de mise à jour sont enregistrés, la nouvelle version distante proposée, la cohérence du transient (données de mise à jour mises en cache), l'état de la licence et le domaine normalisé.
Si vous contactez le support au sujet d'un problème de mise à jour ou de licence, utilisez le rapport JSON copiable au bas de la carte et collez-le dans votre ticket.

Cette carte est un moyen rapide de confirmer que l'extension peut voir et appliquer les mises à jour privées sans exposer d'identifiants sensibles.

Vérifier les tâches planifiées

Faites défiler jusqu'à Tâches en arrière-plan.
L'en-tête de la carte affiche un badge indiquant si la planification s'exécute via WP-Cron ou un Cron du serveur, ainsi qu'une note d'activité telle que Dernière importation exécutée il y a X ou Aucune exécution d'importation récente détectée.
Examinez le tableau : chaque ligne montre la tâche cron, sa planification, l'horodatage de la prochaine exécution et un badge d'état. Les tâches peuvent inclure des travaux d'importation, de file d'attente d'images, d'analyses et d'Analyse des prix.
En plus de l'état normal de prochaine exécution, une tâche peut signaler Verrou bloqué, Géré par le cron du serveur ou Non planifié.
Si le cron intégré de WordPress est désactivé (DISABLE_WP_CRON), un avertissement s'affiche ; dans ce cas, configurez un planificateur côté serveur qui appelle wp-cron.php.
Utilisez les boutons intégrés pour Lancer l'importation maintenant, Lancer la file d'attente d'images maintenant ou Vider la file d'attente d'images si nécessaire.

Vérifier la compatibilité du serveur

Lisez Exigences de l'extension pour connaître les versions minimales et les drapeaux de fonctionnalités, y compris la disponibilité de ZipArchive et l'état de ionCube Loader (avec sa Version du chargeur).
Lisez Serveur et stockage pour la configuration PHP : - memory_limit, WP Memory Limit, max_execution_time, upload_max_filesize, post_max_size, max_input_vars. - SAPI PHP et OS du serveur. - État du répertoire des téléversements et espace disque libre.

Inspecter le fichier journal et la file d'attente d'images

État du fichier journal indique si le fichier journal existe, sa taille actuelle, la marge restante avant rotation, l'heure de la dernière rotation et le chemin du fichier.
État de la file d'attente d'images affiche les importations d'images en attente ainsi que les statistiques de la dernière exécution du worker (nombre d'éléments traités, erreurs, éléments restants).

Référence de configuration

L'écran Système et aide ne stocke pas ses propres réglages. Il lit la configuration actuelle de WordPress, les options de l'extension et l'état d'exécution.

Badges de connectivité et d'API

Ligne	États possibles
État du point de terminaison de l'API AS24	`ok` (configuré et accessible), `bad` (pas d'URL de base ou inaccessible).
Accessibilité de l'API AS24	Résultat de type latence avec `ok` / `warn` / `bad` ; étiquettes telles que Connexion active, Hôte accessible, point de terminaison de l'API non vérifié, ou Erreur serveur (HTTP n). Mis en cache pendant 60 secondes.
État du jeton	`Valid`, `Valid — expires <time>`, `Expires soon` (moins de 5 minutes), `Expired`, `No token`.
État de l'API REST	Point de terminaison accessible, par ex. Actif, la protection par jeton fonctionne (le point de terminaison rejette un jeton de test de santé invalide avec HTTP 403) ; Point de terminaison REST non trouvé (HTTP 404) ; ou inaccessible.
Accessibilité de Market Hub	Modèle similaire à la vérification de l'API AS24.

Le libellé exact des étiquettes peut différer légèrement d'une version de l'extension à l'autre ; fiez-vous à la couleur du badge et aux détails de l'info-bulle plutôt qu'au texte précis.

La ligne de l'API REST n'est entièrement vérifiée que lorsqu'un jeton cron a été généré dans Référence des importations et des limites. Sinon, elle affiche Not checked — no cron token configured.

Diagnostics des mises à jour privées

Cette carte présente l'état de santé des mises à jour et des licences de l'extension. Ses lignes comprennent généralement la version installée, si les crochets de mise à jour sont enregistrés, la nouvelle version distante proposée, la cohérence du transient (données de mise à jour mises en cache), l'état de la licence et le domaine normalisé. Un rapport JSON copiable au bas regroupe ces valeurs pour le support.

Seuils du serveur

Réglage	`ok`	`warn`	`bad`
`memory_limit`	≥ 256 Mo ou illimité	128–255 Mo	< 128 Mo
`max_execution_time`	> 60 s ou illimité	30–60 s	< 30 s

Les autres valeurs PHP (upload_max_filesize, post_max_size, max_input_vars, possibilité d'écriture dans le répertoire des téléversements, espace disque libre) sont présentées avec leurs valeurs actuelles et un badge contextuel.

Actions des tâches en arrière-plan

Bouton	Effet
Lancer l'importation maintenant	Déclenche l'importation régulière une fois, immédiatement.
Lancer la file d'attente d'images maintenant	Traite le lot suivant de la file d'attente d'images.
Vider la file d'attente d'images	Vide la file d'attente d'images en attente. Destructif.

Notes opérationnelles

Les vérifications de connectivité utilisent un délai d'expiration court et un agent utilisateur personnalisé, et mettent en cache leur résultat pendant environ une minute pour éviter de surcharger les services en amont. Elles n'utilisent pas toutes la même méthode HTTP : la vérification de AutoScout24 émet une requête HEAD, tandis que l'auto-vérification REST de l'extension et la sonde de santé de Market Hub utilisent GET (la sonde Market Hub cible un point de terminaison /v1/health).
Le bouton Télécharger les diagnostics dans la barre d'action supérieure produit un package de diagnostic (un ZIP si pris en charge, sinon un fichier JSON) à joindre à une demande de support.
L'info-bulle d'expiration du jeton utilise le fuseau horaire du site WordPress pour l'affichage, mais la valeur mise en cache est stockée sous forme d'horodatage UNIX.
La vérification de l'API REST utilise intentionnellement un jeton invalide — une installation saine répond par HTTP 403. HTTP 404 indique que le point de terminaison n'est pas accessible (généralement un problème de permaliens ou de réécriture).
Si DISABLE_WP_CRON est actif, les tâches planifiées ne s'exécuteront pas à moins que l'hôte ne soit configuré pour appeler wp-cron.php par lui-même. Les importations et le traitement des images sembleront bloqués sans cela.
Le badge d'avertissement de la file d'attente d'images apparaît lorsque la taille de la file d'attente dépasse le seuil interne de l'extension (actuellement 1 000 éléments en attente).
L'espace disque libre est signalé au mieux. Certains hébergeurs masquent cette information ; dans ce cas, le badge affiche Impossible de déterminer.

Dépannage

L'accessibilité de l'API AS24 est bad. L'URL de base dans les Réglages est manquante, mal formée ou le service en amont est en panne. Vérifiez l'info-bulle pour connaître l'erreur sous-jacente.
L'état du jeton est No token. Enregistrez un Client ID et un Secret valides dans les Réglages, puis lancez Tester la connexion dans les Outils.
L'état de l'API REST signale que le point de terminaison n'a pas été trouvé (HTTP 404). Les permaliens personnalisés sont désactivés, ou une autre extension surcharge le routage REST. Enregistrez à nouveau les permaliens sous Settings → Permalinks.
La ligne API REST indique "Non vérifié — aucun jeton cron configuré." Ouvrez la Référence des importations et des limites et générez un jeton cron.
Les tâches en arrière-plan ont une "Prochaine exécution" obsolète. Le cron de WordPress est désactivé ou aucun trafic ne visite le site. Utilisez le bouton Lancer l'importation maintenant pour confirmer que la tâche elle-même s'exécute, puis planifiez un déclencheur côté serveur.
memory_limit a signalé bad. Augmentez memory_limit dans php.ini ou wp-config.php (define('WP_MEMORY_LIMIT', '256M');) — requis pour les importations volumineuses.
La file d'attente d'images ne cesse de croître. Cliquez sur Lancer la file d'attente d'images maintenant pour traiter un lot. Si le nombre continue d'augmenter, réduisez le nombre d'images importées par véhicule dans les Réglages ou augmentez la fréquence d'exécution du worker dans la Référence des importations et des limites.
Le fichier journal est signalé comme bad ou Pas encore de fichier journal. Confirmez que le répertoire des journaux est accessible en écriture. Vérifiez dans la version actuelle de l'extension avant de publier.