Documentation · Première prise en main

Guide d'installation

Ce guide décrit comment installer et activer l'extension ADP Car Market Hub WordPress sur un site WordPress, et comment vérifier que l'installation a réussi avant toute configuration ultérieure.

Il ne couvre pas les identifiants API ni la configuration de l'importation — ces sujets sont traités dans Première configuration, Configuration des identifiants API et Test de connexion.

Quand utiliser ce document

Utilisez ce document si vous devez :

Installer ADP Car Market Hub sur un nouveau site WordPress pour la première fois.
Réinstaller l'extension sur un site existant (par exemple après une migration de serveur ou une reconstruction propre).
Valider qu'une installation effectuée par un tiers (agence, hébergeur, service informatique interne) a été correctement réalisée.
Préparer une procédure d'installation documentée pour une remise au client.

Le public cible est un administrateur WordPress disposant d'un accès complet au back-office et, en cas d'utilisation de l'installation par SFTP, d'identifiants de système de fichiers pour le serveur cible.

Avant de commencer

Confirmez les points suivants avant de commencer l'installation. La plupart des problèmes rencontrés lors de l'installation proviennent du fait que l'un de ces prérequis n'est pas rempli.

Archive de l'extension. Une archive ZIP signée de l'extension ADP Car Market Hub fournie par AD Promotion ou votre canal de distribution. Ne renommez pas l'archive, ne la décompressez pas et ne la re-compressez pas.
Clé de licence. Votre clé de licence ADP Car Market Hub, fournie par AD Promotion. L'extension s'installe et s'active sans elle, mais tous les onglets d'administration à l'exception de Settings restent verrouillés derrière un écran « Licence requise » jusqu'à ce que la licence soit activée. L'activation de la licence est traitée dans Première configuration.
Environnement WordPress. Une installation fonctionnelle de WordPress qui répond aux exigences minimales de l'extension :
WordPress 6.2 ou supérieur (Requires at least: 6.2 dans l'en-tête de l'extension).
PHP 8.1 ou supérieur (Requires PHP: 8.1 dans l'en-tête de l'extension et composer.json).
Une base de données prise en charge par WordPress (MySQL ou MariaDB).
Les extensions PHP openssl, curl, mbstring, json, et l'une de gd ou imagick.
Un répertoire de téléversements accessible en écriture (wp-content/uploads/). Consultez la Configuration requise pour le système technique pour tous les détails.
Connectivité HTTPS sortante. Le serveur web doit être capable de joindre l'hôte de l'API AutoScout24 que vous configurerez plus tard. Consultez la Configuration requise pour l'API, le réseau et le SSL.
Compte administrateur. Un utilisateur WordPress disposant de la capacité manage_options (généralement le rôle administrator) est requis pour installer, activer et configurer l'extension.
Sauvegarde. Une sauvegarde récente et restaurable du site WordPress, y compris la base de données et wp-content/. Les installations en production doivent toujours disposer d'une sauvegarde récente avant d'installer ou d'activer une extension.
Environnement de staging (recommandé). Pour les sites en production, il est fortement recommandé d'installer et de valider d'abord l'extension sur une copie de staging, puis de déployer la configuration en production. Consultez Migration du staging vers le site en production.
Liste de contrôle de pré-installation. Suivez les étapes de la Liste de contrôle de pré-installation pour confirmer que l'hébergement, PHP, la base de données et le réseau sont prêts.

Instructions étape par étape

Il existe deux méthodes d'installation prises en charge :

Option A — Téléversement du ZIP via l'administration WordPress (recommandé pour la plupart des environnements).
Option B — Téléversement manuel par SFTP (recommandé lorsque l'administration WordPress interdit le téléversement d'extensions, lorsque l'environnement d'hébergement impose des systèmes de fichiers en lecture seule pour l'utilisateur administrateur, ou lors d'une installation dans le cadre d'un pipeline de déploiement).

Utilisez l'une ou l'autre de ces méthodes ; ne lancez pas les deux en même temps.

Option A — Installer via l'administration WordPress (téléversement du ZIP)

Connectez-vous à WordPress en tant qu'administrateur.
Dans le menu d'administration de gauche, ouvrez Extensions → Ajouter.
Cliquez sur Téléverser une extension en haut de la page.
Cliquez sur Choisir un fichier et sélectionnez l'archive ZIP ADP Car Market Hub.
Cliquez sur Installer maintenant et attendez que WordPress téléverse et décompresse l'archive.
Une fois le téléversement terminé, cliquez sur Activer l'extension.

Si le téléversement échoue avec une erreur de taille ou de mémoire, il s'agit normalement d'une limite côté serveur (upload_max_filesize, post_max_size, memory_limit, ou une restriction de pare-feu d'application web). Résolvez cette limite avec votre hébergeur, ou utilisez l'Option B.

Option B — Installer manuellement via SFTP

Décompressez l'archive ZIP ADP Car Market Hub sur votre ordinateur local. Vous devriez obtenir un dossier unique nommé adp-car-market-hub/ contenant les fichiers de l'extension.
Connectez-vous au serveur WordPress en utilisant le protocole SFTP (ou SSH) avec un compte autorisé à écrire dans wp-content/plugins/.
Téléversez l'intégralité du dossier adp-car-market-hub/ dans wp-content/plugins/ afin que le chemin final soit wp-content/plugins/adp-car-market-hub/.
Vérifiez que wp-content/plugins/adp-car-market-hub/adp-car-market-hub.php existe sur le serveur. WordPress identifie l'extension grâce à ce fichier principal.
Connectez-vous à WordPress en tant qu'administrateur.
Ouvrez Extensions → Extensions installées, localisez ADP Car Market Hub dans la liste et cliquez sur Activer.

Ne modifiez pas manuellement les permissions des fichiers de l'extension, sauf si votre hébergeur l'exige explicitement. L'extension n'a pas besoin d'accès en écriture à son propre répertoire.

Vérifications d'activation

Après avoir cliqué sur Activer, WordPress devrait afficher une notification de succès et ADP Car Market Hub devrait apparaître dans la liste des extensions actives.

Si l'activation est bloquée, WordPress affiche un message décrivant la raison. Les causes les plus fréquentes sont :

Le site ne respecte pas les versions minimales de WordPress ou de PHP requises par l'extension.
Une extension PHP requise est manquante.
Une installation précédente et incomplète de l'extension existe toujours sur le disque.
Les permissions de fichiers sur wp-content/plugins/ empêchent WordPress de finaliser l'activation.

Résolvez le problème sous-jacent et tentez à nouveau l'activation. L'extension ne modifie pas les thèmes ou d'autres extensions lors de l'activation.

Vérifications post-activation

Effectuez ces vérifications immédiatement après une activation réussie. Elles confirment que l'extension s'est chargée correctement et qu'elle est prête à être configurée.

Menu d'administration. Confirmez qu'une nouvelle entrée de menu de premier niveau Car Market Hub est visible dans la barre latérale d'administration de WordPress (le nom d'affichage de l'extension dans le menu est raccourci — le fichier de l'extension lui-même est enregistré sous le nom ADP Car Market Hub). Survolez l'entrée pour voir les éléments de sous-menu disponibles, notamment Dashboard, Settings, Car Importer, Import & Limits, Tools, System & Help, Logs et d'autres.
Liens d'action de l'extension. Sur la page Extensions → Extensions installées, la ligne ADP Car Market Hub doit désormais afficher un lien License activation et un lien Settings en plus de Désactiver. License activation ouvre la page des réglages ancrée sur la carte d'activation de la licence ; Settings ouvre la page des réglages de l'extension.
Affichage de la page des réglages. Ouvrez Car Market Hub → Settings. La page doit se charger sans avertissements PHP, erreurs fatales ou alertes de ressources manquantes. La carte License Activation doit apparaître en haut de la page, et les champs API Base URL, Seller ID, Client ID, Client Secret et Default currency doivent être visibles et vides (sur une nouvelle installation). Sur une nouvelle installation, les autres onglets de l'extension affichent un écran « Licence requise » jusqu'à ce qu'une licence soit activée.
System & Help. Ouvrez Car Market Hub → System & Help. La page doit afficher les vérifications de l'environnement (PHP, JSON, OpenSSL, cURL, GD/Imagick, téléversements) avec des badges d'état de type feux tricolores. Une nouvelle installation qui répond aux exigences ne doit pas afficher de badges rouges ; une extension manquante ou un répertoire non accessible en écriture sera signalé ici. Corrigez tout problème avant de continuer.
Aucune erreur fatale dans les journaux. Confirmez que le journal de débogage de WordPress (s'il est activé) et le journal des erreurs de votre hébergement ne présentent pas d'erreurs fatales liées à l'extension. L'extension gère son propre fichier journal à l'emplacement wp-content/uploads/as24ci-logs/, qui sera créé automatiquement lors de la première utilisation.

Si l'une de ces vérifications échoue, ne passez pas aux étapes de configuration. Résolvez d'abord le problème ou restaurez la sauvegarde la plus récente.

Notification de l'assistant de première configuration

Après la première activation de l'extension, une notification d'administration intitulée Welcome to ADP Car Market Hub apparaît en haut de chaque page d'administration de WordPress. La notification propose deux boutons :

Start Setup Wizard ouvre l'Assistant de première configuration, un parcours en sept étapes (licence, mode, profil du concessionnaire, AutoScout24, pages, fonctionnalités, fin). L'activation de la licence est la première étape obligatoire ; les étapes suivantes sont facultatives.
Skip for now masque la notification. L'assistant reste accessible depuis le Dashboard et depuis Car Market Hub → Tools.

La notification n'est pas une redirection forcée. Elle n'apparaît que lorsque l'horodatage de la première activation vient d'être enregistré et que l'assistant n'a pas encore été complété ou ignoré. Les mises à jour de l'extension qui ne déclenchent pas une nouvelle activation n'affichent pas la notification sur les installations existantes. L'assistant est facultatif mais recommandé ; tout ce qu'il propose peut également être configuré manuellement via les onglets d'administration habituels.

Notes de configuration

Ce document ne couvre que l'installation. Les points suivants s'appliquent spécifiquement à l'étape d'installation/activation :

Slug et dossier de l'extension. Le nom de dossier attendu est adp-car-market-hub. Le renommage du dossier n'est pas pris en charge et affectera la capacité de WordPress à gérer les mises à jour.
Type de publication personnalisé et taxonomies. Lors de l'activation, l'extension enregistre le type de publication personnalisé as24ci_car et un ensemble de taxonomies de véhicules. Ce sont des éléments techniques qui ne nécessitent pas de configuration manuelle.
Tables de base de données personnalisées. L'extension crée ses propres tables de base de données lors de l'activation via dbDelta() (par exemple pour les événements d'analyse et les alertes de recherche enregistrées). Aucun SQL manuel n'est requis.
Capacité et rôle personnalisés. L'extension fournit sa propre capacité et un rôle délégué utilisé pour la gestion quotidienne. L'installation et la configuration initiales doivent tout de même être effectuées par un administrateur WordPress complet. Consultez Contrôle d'accès et capacités.
Aucune importation de données lors de l'activation. L'activation n'importe aucun véhicule et ne contacte pas AutoScout24. Les importations ne commencent qu'après la configuration des identifiants et le déclenchement d'une importation.

Notes opérationnelles

Mises à jour. Les futures mises à jour de l'extension doivent être appliquées via le même canal que celui utilisé pour l'installation (téléversement d'un nouveau ZIP dans l'administration, ou remplacement du dossier de l'extension par SFTP). Conservez le slug et le nom du dossier de l'extension inchangés afin de préserver les réglages, les véhicules et les leads. Effectuez toujours une sauvegarde récente avant de mettre à jour en production.
Désactivation. La désactivation de l'extension désactive ses fonctionnalités mais conserve les véhicules importés, les options, les leads et les données d'analyse dans la base de données. L'extension ne supprime ses données que lors de la désinstallation, et uniquement lorsque le réglage de nettoyage correspondant est activé. Consultez Désinstallation et nettoyage des données.
Multisite. ADP Car Market Hub est conçu pour être activé sur le site individuel qui doit afficher l'inventaire des véhicules, et non sur l'ensemble du réseau. Confirmez avec votre administrateur d'hébergement / de réseau avant de l'installer sur un environnement multisite.
Rigueur en production. Les installations en production doivent suivre une procédure de déploiement documentée : sauvegarde → installation sur le staging → validation → installation en production → nouvelle vérification. Consultez Migration du staging vers le site en production.

Dépannage

Symptôme	Cause probable	Ce qu'il faut vérifier
Le téléversement échoue avec le message « Le lien que vous avez suivi a expiré » ou une erreur de taille.	Les limites de téléversement du serveur (`upload_max_filesize`, `post_max_size`, `memory_limit`) ou une règle WAF sont trop restrictives pour le fichier ZIP.	Augmentez les limites auprès de votre hébergeur, ou effectuez l'installation via SFTP (Option B).
WordPress affiche « L'extension n'a pas d'en-tête valide. »	Le mauvais fichier a été téléversé (par exemple, le fichier ZIP a été décompressé et seuls les fichiers internes ont été re-zippés).	Téléversez à nouveau l'archive ZIP signée d'origine sans modification.
Activation refusée avec une erreur de version PHP / WordPress.	Le site ne répond pas à la configuration minimale requise (`Requires at least: 6.2`, `Requires PHP: 8.1`).	Mettez à jour WordPress et/ou PHP, ou migrez vers un environnement d'hébergement qui les prend en charge.
Activation refusée avec une erreur d'extension manquante.	L'une des extensions PHP requises n'est pas installée (`openssl`, `curl`, `mbstring`, `json`, `gd`/`imagick`).	Demandez à votre hébergeur d'activer l'extension manquante.
L'extension semble active mais le menu Car Market Hub est manquant.	L'utilisateur actuel ne dispose pas des droits requis, ou une autre extension/thème bloque le menu d'administration.	Connectez-vous en tant qu'administrateur complet. Désactivez temporairement les autres extensions de personnalisation de l'administration pour isoler le conflit.
Le lien « Réglages » est manquant sur la ligne de l'extension.	L'activation ne s'est pas déroulée correctement, ou une autre extension surcharge le filtre action-links.	Désactivez et réactivez l'extension. Examinez le journal des erreurs WordPress et le propre journal de l'extension sous `wp-content/uploads/as24ci-logs/`.
`wp-content/uploads/as24ci-logs/` est vide ou manquant après la première utilisation.	Le dossier des téléversements n'est pas accessible en écriture par l'utilisateur du serveur web.	Corrigez la propriété/les permissions du dossier avec votre hébergeur ; sinon, l'extension ne peut pas créer le dossier.
Erreur fatale faisant référence aux classes `AS24CI\`.	Les fichiers de l'extension ont été téléversés de manière incomplète (transfert SFTP interrompu) ou le dossier a été renommé.	Téléversez à nouveau le dossier complet `adp-car-market-hub/` et confirmez que le slug est `adp-car-market-hub`.

Si le problème persiste après ces vérifications, rassemblez les diagnostics décrits dans la Liste de contrôle des informations de support avant de contacter le support.