Documentation · Manuel de l'utilisateur

Manuel de l'administrateur

Ce manuel documente les responsabilités administratives pour l'extension ADP Car Market Hub WordPress. Il couvre la responsabilité de la configuration initiale, les permissions des utilisateurs, la configuration des importations, les opérations planifiées, la surveillance de la santé du système et la coordination du support.

Quand utiliser ce document

Lisez ce document si vous :

Êtes un administrateur WordPress responsable de l'installation, de la configuration et de la maintenance de l'extension.
Avez besoin de comprendre quelles permissions sont requises et comment les gérer.
Êtes responsable de veiller à ce que les importations s'exécutent de manière fiable et d'enquêter sur les échecs.
Coordonnez vos actions avec le support technique ou un partenaire d'intégration.

Pour les tâches opérationnelles quotidiennes telles que la vérification de l'état de l'importation, l'examen des leads et la validation du frontend, consultez les Flux de travail d'utilisation quotidienne.

Aperçu

ADP Car Market Hub nécessite une configuration initiale minutieuse avant de pouvoir importer des véhicules. L'administrateur est responsable de :

Saisir et maintenir des identifiants API valides.
Configurer la planification des importations et choisir entre WP-Cron et le cron du serveur.
Définir l'état par défaut correct des publications, l'auteur, la gestion des images et la devise.
Accorder ou restreindre l'accès à l'interface d'administration de l'extension.
Gérer les contacts commerciaux de la concession affichés aux clients et utilisés pour l'aiguillage des leads (CMH Team).
Surveiller la santé de l'extension, les journaux d'activité et la réussite des importations.
Coordonner les actions avec AutoScout24 ou votre partenaire d'intégration en cas de problèmes d'API.

Configuration requise ou prérequis

Un accès administrateur WordPress est requis pour installer l'extension et gérer les fonctionnalités.
PHP 8.1 ou version ultérieure et WordPress 6.2 ou version ultérieure doivent être exécutés sur le serveur.
Des identifiants API AutoScout24 valides (API Base URL, Seller ID(s), Client ID, Client Secret, Token URL, Audience) doivent être obtenus auprès d'AutoScout24 ou de votre partenaire d'intégration avant la configuration. L'extension ne peut pas importer de véhicules sans ces éléments.
Le serveur doit autoriser les connexions HTTPS sortantes vers le point de terminaison de l'API configuré.
Si le cron du serveur est préféré à WP-Cron, l'environnement d'hébergement doit prendre en charge les tâches planifiées (crontab ou équivalent).

Permissions et fonctionnalités

Fonctionnalité de gestion de l'extension

L'extension introduit une fonctionnalité personnalisée WordPress : manage_as24_imports.

Cette fonctionnalité est requise pour accéder au menu d'administration ADP Car Market Hub, exécuter des importations, modifier les réglages, afficher les leads et utiliser tous les outils d'administration.
Lors de l'activation, les administrateurs WordPress (rôle administrator) reçoivent automatiquement manage_as24_imports.
Les autres rôles d'utilisateur (éditeur, gestionnaire de boutique, etc.) ne reçoivent pas cette fonctionnalité par défaut. Un administrateur WordPress doit l'accorder explicitement à l'aide d'une extension de gestion des rôles ou d'un code personnalisé si l'accès est requis pour des utilisateurs non-administrateurs.

Fonctionnalités de publication WordPress

Le type de publication personnalisé as24ci_car (le menu CMH Cars) utilise ses propres fonctionnalités dédiées WordPress (edit_as24ci_cars, publish_as24ci_cars, etc.). Les fiches de véhicules apparaissent sous CMH Cars → All Cars, et non sous l'écran standard WordPress Articles. L'accès aux pages d'administration dédiées de l'extension sous CMH Center et CMH Team nécessite en outre manage_as24_imports.

Protection des réglages sensibles

Les identifiants API (Client ID et Client Secret) sont stockés dans la table des options WordPress. L'accès à l'onglet Settings est restreint par manage_as24_imports. Assurez-vous que seuls des administrateurs de confiance détiennent cette fonctionnalité.

Première configuration

Suivez ces étapes lors de la configuration initiale de l'extension :

Installez et activez l'extension via l'administration WordPress → Extensions → Ajouter une nouvelle ou en téléversant l'archive de l'extension.
Accédez à ADP Car Market Hub → Settings.
Saisissez l'API Base URL pour votre environnement AutoScout24. Les URL de base courantes incluent les hôtes d'API régionaux d'AutoScout24 (vérifiez l'URL correcte auprès d'AutoScout24 ou de votre partenaire d'intégration).
Saisissez un ou plusieurs Seller IDs (séparés par des virgules) correspondant à votre ou vos comptes de concessionnaire AutoScout24.
Saisissez le Client ID et le Client Secret fournis par AutoScout24.
Saisissez la Token URL et l'Audience si elles diffèrent des valeurs par défaut dérivées de l'URL de base.
Définissez la Devise par défaut pour qu'elle corresponde à la devise utilisée dans vos annonces.
Configurez l'État par défaut des publications (publish pour rendre les véhicules visibles immédiatement, draft pour les examiner avant publication).
Définissez l'Auteur par défaut des publications sur l'utilisateur WordPress qui doit être répertorié comme l'auteur des publications de véhicules.
Configurez les réglages d'importation d'images : s'il faut importer les images, le nombre maximal d'images par véhicule et les options de conversion WebP.
Cochez l'option Créer les pages par défaut pour que l'extension crée automatiquement les pages d'archive de véhicules et de comparaison.
Cliquez sur Enregistrer les modifications.
Utilisez le test de connexion sur l'onglet System & Help ou Tools pour confirmer que les identifiants API fonctionnent.
Accédez à Import & Limits et lancez l'importation complète initiale à l'aide de l'assistant par lots (Batch-Wizard).

Configuration de la planification des importations

WP-Cron (par défaut)

WordPress dispose d'un système de cron intégré (WP-Cron) qui se déclenche lors du chargement des pages. Cela est suffisant pour de nombreux sites, mais peut être retardé sur les sites à faible trafic.

Accédez à ADP Car Market Hub → Import & Limits.
Activez l'Importation automatique.
Choisissez l'intervalle : toutes les heures, toutes les 6 heures, deux fois par jour, tous les jours ou un intervalle personnalisé (minimum 15 minutes).
Pour les planifications quotidiennes et biquotidiennes, définissez l'heure de début préférée.
Enregistrez les réglages d'automatisation.

Cron du serveur (recommandé pour la production)

Pour une planification fiable, configurez un cron de serveur externe pour appeler le point de terminaison REST de l'extension :

Accédez à ADP Car Market Hub → Import & Limits.
Définissez le Mode Cron sur Cron du serveur.
Copiez l'URL du point de terminaison cron affichée (qui inclut un jeton de sécurité).
Ajoutez une tâche cron sur votre serveur (par exemple, en utilisant crontab) pour appeler cette URL à l'intervalle souhaité à l'aide de curl ou wget.
Si vous devez régénérer le jeton (par exemple, après un incident de sécurité), cliquez sur Régénérer le jeton sur le même onglet et mettez à jour votre tâche cron de serveur avec la nouvelle URL.

Verrouillage d'importation

L'extension utilise un verrou temporaire basé sur les transients (environ 40 minutes) pour empêcher les exécutions d'importation de se chevaucher. Si une exécution d'importation est déjà en cours et qu'un second déclencheur arrive (via WP-Cron, le cron du serveur ou un déclenchement manuel), la seconde exécution est ignorée. Il s'agit d'un comportement normal.

Gestion des importations d'images

Mode file d'attente des images : Lors des importations planifiées par cron, seule la première image de chaque véhicule est téléchargée immédiatement. Les images restantes sont traitées par un processus d'arrière-plan de la file d'attente environ toutes les 5 minutes. Cela évite les erreurs de dépassement de temps PHP (timeout) lors d'importations volumineuses.
Surveillance de la file d'attente des images : L'onglet System & Help affiche la taille actuelle de la file d'attente des images et un avertissement si la file d'attente dépasse 1 000 éléments.
Traitement manuel de la file d'attente : Utilisez le bouton Exécuter la file d'attente des images maintenant sur l'onglet System & Help pour traiter la file d'attente immédiatement.
Vider la file d'attente des images : Le bouton Vider la file d'attente des images sur le même onglet supprime toutes les entrées d'images en attente sans les traiter. Utilisez cette option avec prudence.
Conversion WebP : Si elle est activée, les images téléchargées sont converties au format WebP à l'aide de GD ou Imagick. L'onglet System & Help indique si ces extensions sont disponibles.

Synchronisation complète (Full Sync)

La synchronisation complète (Full Sync) est un réglage de l'onglet Import & Limits qui, lorsqu'il est activé, supprime définitivement toute publication de véhicule dans WordPress qui n'est plus présente dans l'inventaire en direct d'AutoScout24 pour le ou les vendeurs configurés.

N'utilisez la synchronisation complète que lorsque vous souhaitez que WordPress reflète exactement l'inventaire en direct d'AutoScout24. Lorsqu'elle est activée :

Toute publication locale de véhicule non trouvée dans l'inventaire distant actuel est définitivement supprimée, y compris toutes les images jointes.
Cela inclut les véhicules qui ont été modifiés manuellement, enrichis de contenu supplémentaire ou définis à l'état de brouillon.
La suppression est enregistrée dans le fichier journal de l'extension.

Désactivez la synchronisation complète si vous souhaitez conserver les véhicules dans WordPress même après leur retrait d'AutoScout24.

Surveillance de la santé du système

L'onglet System & Help fournit un aperçu complet de l'environnement du serveur et de l'état de l'extension. Consultez-le régulièrement pour identifier les problèmes potentiels avant qu'ils n'affectent les importations.

Contrôles clés :

Contrôle	Valeur recommandée	Notes
Version de PHP	8.1 ou ultérieure	Requis
Limite de mémoire	256 Mo ou plus	Des valeurs inférieures peuvent provoquer des échecs d'importation
Temps d'exécution max	60 secondes ou plus	Recommandé pour les importations volumineuses
Répertoire des téléversements	Accessible en écriture	Requis pour les importations d'images
GD ou Imagick	Présent	Requis pour la conversion WebP
cURL	Présent	Requis pour les appels API
OpenSSL	Présent	Requis pour les connexions API HTTPS
Connexion API	OK	Confirme que les identifiants fonctionnent
Taille de la file d'images	Moins de 1 000	Une file d'attente importante indique un retard de traitement
État de planification cron	Actif	Confirme que WP-Cron ou le cron externe fonctionne

Les indicateurs d'état utilisent un système de feux tricolores : vert (OK), jaune (avertissement), rouge (problème).

Surveillance des journaux

L'onglet Logs affiche le journal d'activité de l'extension.

Le journal enregistre les appels API, les demandes de jetons, les actions d'importation, les téléchargements d'images, les erreurs et les avertissements.
Les panneaux Recent Errors et Recent Warnings en haut de l'onglet Logs mettent en évidence les dernières entrées d'erreurs et d'avertissements parmi les 2 000 dernières lignes du journal.
Le Log Viewer affiche les N dernières lignes du fichier journal complet (configurable, de 100 à 2 000 lignes).
Le fichier journal subit une rotation automatique lorsqu'il atteint 10 Mo.
Pour effacer manuellement le fichier journal, cliquez sur le bouton Effacer le fichier journal. Cette action est irréversible.
La Journalisation détaillée (lorsqu'elle est activée dans les réglages) écrit des détails par véhicule et par image dans le journal. Désactivez la journalisation détaillée en production si le journal grossit trop rapidement.

Exportation des diagnostics

L'onglet Tools comprend une fonction d'Exportation des diagnostics. Celle-ci génère un fichier JSON contenant :

La version de l'extension
La version de WordPress
La version de PHP
L'URL du site
La taille et le chemin du fichier journal
Un résumé de l'environnement système

Lorsque vous contactez le support, exportez ce fichier et partagez-le avec votre équipe d'assistance. Ne partagez pas le fichier journal brut publiquement, car il peut contenir des URL d'API et des identifiants d'annonces.

Gérer les fonctionnalités

La plupart des fonctionnalités facultatives sont activées ou désactivées depuis l'écran Settings plutôt que depuis un onglet dédié « Fonctionnalités ». Ouvrez Car Market Hub → Settings et utilisez les cartes Frontend Features et Admin Features pour activer ou désactiver des fonctionnalités individuelles. Les modifications prennent effet immédiatement après l'enregistrement. Les options disponibles incluent :

Données structurées Schema.org et balises méta Open Graph
Boutons de partage sur les réseaux sociaux
Favoris / Liste d'envies
Comparateur de véhicules
Fiche technique PDF
Intégration du plan de site (Sitemap)
Widget du tableau de bord
Chargement différé (Lazy loading)
Actions groupées
Exportation
REST API
Suivi analytique
Calculateur de financement (avec taux d'intérêt, durée du prêt et apport configurables)
Réservation d'essai routier
AI Assistant

Désactiver une fonctionnalité supprime son fonctionnement à la fois du frontend et de l'administration sans supprimer les données stockées. Consultez la Référence des réglages pour la liste complète des options.

Les URL de webhooks sortants (nouveau lead, nouvelle importation) et le secret du webhook sont configurés sur l'écran Leads — voir la Référence des leads. L'option de la fiche technique PDF se trouve dans Settings, tandis que ses modèles et sa charte graphique sont gérés dans le PDF Manager (voir la Référence du PDF Manager).

L'AI Assistant et le Content Studio ne sont pas de simples options d'activation/désactivation de la même manière. L'AI Assistant est configuré sur son propre écran CMH Center → AI Assistant, et le Content Studio est un espace de travail distinct CMH Center → Content Studio. Ces zones opérationnelles peuvent également nécessiter une licence d'extension active avant de pouvoir être utilisées ; si l'extension ne dispose pas de licence pour celles-ci, l'écran est remplacé par un avis « licence requise » et les données existantes restent inchangées.

Gérer la CMH Team

CMH Team est un menu de premier niveau distinct pour les contacts commerciaux de la concession gérés par l'extension. Les membres de l'équipe sont stockés entièrement au sein de l'extension (aucun compte utilisateur WordPress n'est requis) et peuvent être affichés sur les pages de détails des véhicules et utilisés comme destinataires privilégiés pour les leads.

Le menu CMH Team propose les écrans suivants :

Écran	Objectif
Overview	Résumé de la configuration de l'équipe avec des liens rapides.
Members	Liste de tous les contacts commerciaux ; ajouter, modifier ou supprimer des membres.
New	Créer ou modifier un membre individuel (nom, photo, e-mail, téléphone, rôle).
Locations	Définir un contact par défaut par emplacement de concessionnaire / Seller ID.
Assignment	Assigner un contact à des véhicules individuels (manuel, automatique, contact général de la concession, ou aucun).
Standards	Contact de secours global et coordonnées générales de la concession.
Rules	Comportement d'attribution automatique, y compris si une copie de chaque demande est également envoyée à l'e-mail général de la concession.

Comment un contact est résolu pour un véhicule donné : un contact attribué manuellement par véhicule est prioritaire, puis le contact par défaut de l'emplacement/vendeur, puis le contact par défaut global. Les choix manuels (manuel, général, aucun) ne sont jamais écrasés par l'importateur ; les attributions automatiques peuvent être actualisées lors de l'importation. Consultez CMH Team and Contact Routing pour la référence complète, et le Flux de travail de gestion des leads pour savoir comment la CMH Team affecte le routage des notifications de leads.

Gérer les leads

Les demandes de contact client et d'essai routier sont stockées sous forme de types de publication personnalisés WordPress (as24ci_lead) et affichées dans l'onglet Leads.

Responsabilités de l'administrateur :

Configurer l'adresse e-mail du destinataire pour les notifications de leads (onglet Leads).
Examiner périodiquement les statuts des leads et les mettre à jour en Contacté, Fermé ou Indésirable selon le cas.
Exporter les leads au format CSV pour l'importation dans un CRM ou pour l'archivage.
Supprimer les leads obsolètes ou indésirables de l'onglet Leads.

Remarque : Les enregistrements de publications de leads sont stockés dans WordPress. Si l'option Delete data on uninstall est activée dans Settings, ces enregistrements seront définitivement supprimés lors de la désinstallation de l'extension.

Désinstallation et nettoyage

L'onglet Settings comprend une option Delete data on uninstall. Lorsque celle-ci est activée :

La désinstallation de l'extension via WordPress Admin → Extensions supprimera définitivement toutes les publications de véhicules importés, les publications de leads, les images importées et les options de l'extension.

Lorsque cette option est désactivée (par défaut), la désinstallation de l'extension laisse toutes les données dans WordPress. Vous pouvez ensuite réinstaller l'extension et reprendre l'activité sans perte de données.

N'activez cette option que si vous envisagez une suppression complète. Cette action ne peut pas être annulée une fois la désinstallation terminée.

Coordination du support

Lorsqu'un problème nécessite une remontée vers AutoScout24 ou votre partenaire d'intégration :

Consultez l'onglet Logs pour rechercher les messages d'erreur pertinents et notez l'horodatage.
Exportez le fichier de Diagnostics depuis l'onglet Tools.
Notez la version de l'extension (affichée dans la liste des extensions et dans l'onglet System & Help) ainsi que les versions de WordPress et de PHP.
Confirmez si le test de connexion API réussit (System & Help → test de connexion).
Fournissez l'ensemble de ces éléments à votre contact de support. Ne partagez pas le Client Secret brut.

Dépannage

Symptôme	Cause probable	Vérification
L'onglet Settings affiche « invalid API Base URL »	URL saisie sans format ou protocole valide	Saisissez une URL complète incluant `https://`
Le test de connexion échoue	Identifiants incorrects, mauvaise Base URL ou blocage réseau	Vérifiez les identifiants avec votre partenaire d'intégration ; vérifiez les règles du pare-feu
L'importation planifiée ne s'exécute pas	WP-Cron est désactivé ou le site n'a pas de trafic	Passez à un cron système ; vérifiez que le point de terminaison cron est accessible
Capacité manageas24imports non attribuée	L'activation de l'extension n'a pas finalisé la mise à niveau des capacités	Désactivez puis réactivez l'extension ; ou attribuez la capacité manuellement
La synchronisation complète (Full Sync) a supprimé des véhicules de manière inattendue	La synchronisation complète était activée et les véhicules ont été retirés d'AutoScout24	Consultez les Logs pour rechercher les entrées de suppression ; désactivez la synchronisation complète si elle n'est pas nécessaire
L'importation s'exécute mais aucun véhicule n'apparaît	Le statut de publication par défaut est `draft`	Modifiez le statut de publication par défaut en `publish` dans Settings
La conversion WebP échoue	GD ou Imagick n'est pas disponible	Vérifiez l'état de l'extension dans System & Help ; contactez l'hébergeur
L'exportation des diagnostics échoue	Autorisations PHP insuffisantes pour lire les données d'environnement	Examinez le journal des erreurs PHP sur le serveur