Documentation · Prise en main

Guide d'installation

Ce guide décrit comment installer et activer le plugin 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 êtes en train de :

Installer ADP Car Market Hub sur un nouveau site WordPress pour la première fois.
Réinstaller le plugin 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, des identifiants du 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 de l'un de ces prérequis non finalisé.

Archive du plugin. Une archive ZIP signée du plugin 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. Le plugin s'installe et s'active sans elle, mais chaque onglet d'administration, à l'exception de Settings, reste verrouillé 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 WordPress fonctionnelle qui répond aux exigences minimales du plugin :
WordPress 6.2 ou supérieur (Requires at least: 6.2 dans l'en-tête du plugin).
PHP 8.1 ou supérieur (Requires PHP: 8.1 dans l'en-tête du plugin 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/). Voir 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. Voir 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 le plugin.
Sauvegarde. Une sauvegarde récente et restaurable du site WordPress, y compris la base de données et wp-content/. Les installations de production doivent toujours disposer d'une sauvegarde récente avant d'installer ou d'activer un plugin.
Environnement de staging (recommandé). Pour les sites de production, il est fortement recommandé d'installer et de valider d'abord le plugin sur une copie de staging, puis de promouvoir la configuration en production. Voir Staging to Live Migration.
Liste de contrôle de pré-installation. Suivez la Liste de contrôle de pré-installation pour confirmer la préparation de l'hébergement, de PHP, de la base de données et du réseau.

Instructions étape par étape

Il existe deux parcours d'installation pris 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 de plugins, 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'un ou l'autre parcours ; ne lancez pas les deux en même temps.

Option A — Installer via l'administration WordPress (téléversement de 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 du plugin.
Connectez-vous au serveur WordPress en utilisant 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 le plugin 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 du plugin, sauf si votre hébergeur l'exige explicitement. Le plugin 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 plugins actifs.

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

Le site ne respecte pas les versions minimales de WordPress ou de PHP requises par le plugin.
Une extension PHP requise est manquante.
Une installation précédente et incomplète du plugin 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. Le plugin ne modifie pas les thèmes ou d'autres plugins lors de l'activation.

Vérifications post-activation

Effectuez ces vérifications immédiatement après une activation réussie. Elles confirment que le plugin s'est chargé correctement et qu'il est prêt à être configuré.

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 du plugin dans le menu est raccourci — le fichier du plugin 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, Universal Import, Car Importer, Import & Limits, Tools, System & Help, Logs et d'autres.
Liens d'action du plugin. 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 licence ; Settings ouvre la page des réglages du plugin.
Rendu de la page des réglages. Ouvrez Car Market Hub → Settings. La page doit se charger sans notifications PHP, erreurs fatales ou avertissements de ressources manquantes. La carte License Activation doit apparaître en haut de la page, suivie de General Settings (devise par défaut) et d'une fine carte Data sources & API connections avec un bouton Manage data sources. Les identifiants API ne sont plus saisis ici — ils se trouvent dans Car Market Hub → Universal Import, où la source AutoScout24 affiche les champs API Base URL, Seller ID, Client ID et Client Secret (vides lors d'une nouvelle installation). Sur une nouvelle installation, les autres onglets du plugin 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 de statut de type feu tricolore. 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 d'erreurs de votre hébergement ne présentent pas d'erreurs fatales liées au plugin. Le plugin 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 du plugin, 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'First Setup Wizard, 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 tableau de bord 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 du plugin 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 du plugin. 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, le plugin enregistre le type de publication personnalisé as24ci_car ainsi qu'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. Le plugin 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. Le plugin 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. Voir Access Control and Capabilities.
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'une fois les identifiants configurés et une importation déclenchée.

Notes opérationnelles

Mises à jour. Les futures mises à jour du plugin 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 du plugin par SFTP). Conservez le slug et le nom du dossier du plugin 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 du plugin 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. Le plugin ne supprime ses données que lors de la désinstallation, et uniquement lorsque le réglage de nettoyage correspondant est activé. Voir Uninstall and Data Cleanup.
Multisite. ADP Car Market Hub est destiné à ê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.
Discipline de production. Les installations de production doivent suivre une procédure de déploiement documentée : sauvegarde → installation sur le staging → validation → installation sur la production → re-vérification. Voir Staging to Live Migration.

Dépannage

Symptôme	Cause probable	Ce qu'il faut vérifier
L'envoi échoue avec le message « Le lien que vous avez suivi a expiré » ou une erreur de taille.	Les limites d'envoi 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 installez le plugin via SFTP (Option B).
WordPress affiche « L'extension ne dispose pas d'un en-tête valide. »	Le mauvais fichier a été envoyé (par exemple, le ZIP a été décompressé et seuls les fichiers internes ont été re-zippés).	Renvoyez 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.
Le plugin semble actif mais le menu Car Market Hub est manquant.	L'utilisateur actuel ne dispose pas des droits requis, ou un autre plugin/thème bloque le menu d'administration.	Connectez-vous en tant qu'administrateur complet. Désactivez temporairement les autres plugins de personnalisation de l'administration pour isoler le conflit.
Le lien « Réglages » est manquant sur la ligne du plugin.	L'activation ne s'est pas déroulée correctement, ou un autre plugin surcharge le filtre action-links.	Désactivez puis réactivez le plugin. Examinez le journal des erreurs WordPress et le propre journal du plugin sous `wp-content/uploads/as24ci-logs/`.
`wp-content/uploads/as24ci-logs/` est vide ou manquant après la première utilisation.	Le répertoire des téléversements (uploads) n'est pas accessible en écriture par l'utilisateur du serveur web.	Corrigez la propriété/les permissions du répertoire avec votre hébergeur ; sinon, le plugin ne peut pas créer le répertoire.
Erreur fatale faisant référence à des classes `AS24CI\`.	Les fichiers du plugin ont été envoyés de manière incomplète (transfert SFTP interrompu) ou le dossier a été renommé.	Renvoyez l'intégralité du dossier `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.