Documentation · Première prise en main

Liste de contrôle de mise en production

Ce document est la liste de contrôle de préparation à la production pour ADP Car Market Hub. Il rassemble tous les éléments transversaux qui doivent être confirmés avant que les importations automatiques ne soient activées sur le site WordPress en production d'un client, afin que le lancement soit prévisible et réversible.

Il complète plutôt qu'il ne remplace la Première configuration : la Première configuration décrit comment configurer l'extension étape par étape ; ce document décrit comment vérifier que la configuration peut être basculée en toute sécurité vers une exploitation réelle.

Quand utiliser ce document

Utilisez ce document si vous êtes :

Une agence ou un partenaire d'intégration sur le point de livrer un nouveau déploiement de ADP Car Market Hub à un client.
Un administrateur WordPress transférant une configuration de staging validée vers un site de production.
Une équipe d'hébergement chargée de confirmer que l'environnement de production est dimensionné et configuré pour les importations planifiées.
Un responsable des opérations effectuant un re-lancement contrôlé après une migration de serveur, un changement de domaine, un renouvellement de certificat ou une mise à jour majeure de l'extension.

Le public visé est technique : un administrateur WordPress disposant d'un accès complet au back-office, travaillant en collaboration (le cas échéant) avec l'hébergeur et avec le détenteur des accès API AutoScout24 du concessionnaire.

Aperçu

Une mise en production pour ADP Car Market Hub n'est pas une action unique — l'activation des importations automatiques est la dernière étape d'une chaîne qui dépend de :

La préparation de l'hébergement et de l'environnement PHP.
Des identifiants API corrects et appartenant à la concession.
Un test de connexion réussi et reproductible, et au moins une importation de test réussie.
Un frontend qui a été examiné par rapport à de vraies données de véhicules importées.
Des paramètres juridiques, de confidentialité et de consentement conformes aux politiques publiées de la concession.
Une procédure de retour arrière documentée en cas de défaillance après le lancement.

La liste de contrôle ci-dessous est regroupée par thème. Chaque élément doit être coché ou explicitement accepté avec un motif documenté avant que le site ne soit ouvert au trafic réel avec des importations en direct.

Prérequis avant de parcourir la liste de contrôle

Confirmez que tous les éléments suivants sont en place avant d'ouvrir cette liste de contrôle :

L'extension est installée et activée sur le site de production (voir le Guide d'installation).
Un environnement de staging configuré existe et la même configuration a été répliquée en production (voir Staging to Live Migration).
Les identifiants API du compte du concessionnaire sont disponibles via un canal sécurisé (voir la Configuration des identifiants API, AutoScout24 API Setup et External API Credentials).
Le site dispose d'une sauvegarde récente et restaurable qui inclut la base de données et wp-content/.
Les parties prenantes (concession, agence, hébergeur) se sont accordées sur un créneau horaire de mise en production pour surveiller les premières importations.

Instructions étape par étape

Parcourez les sections dans l'ordre. N'activez pas la planification automatique tant que chaque élément applicable n'a pas été confirmé.

1. Environnement et infrastructure

[ ] WordPress respecte la version minimale requise pour l'extension (Requires at least: 6.2) et PHP respecte le minimum requis (Requires PHP: 8.1). Voir la Configuration requise pour le système technique.
[ ] Les extensions PHP requises sont présentes : openssl, curl, mbstring, json, et l'une des extensions gd ou imagick. Voir la Configuration requise pour PHP et la base de données.
[ ] Les requêtes HTTPS sortantes vers l'hôte API AutoScout24 configuré sont autorisées par le pare-feu d'hébergement et tout WAF en amont du site. Voir la Configuration requise pour l'API, le réseau et le SSL.
[ ] Le bundle CA du serveur fait confiance à la chaîne de certificats de l'hôte API (aucune erreur de validation SSL/TLS lors du test de connexion).
[ ] Le répertoire wp-content/uploads/ est accessible en écriture par l'utilisateur du serveur web, et wp-content/uploads/as24ci-logs/ est créé ou peut être créé pour la journalisation de l'extension.
[ ] Un espace disque suffisant est disponible pour la médiathèque prévue (images des véhicules importés, y compris les variantes WebP si la conversion est activée).
[ ] Les ressources du serveur (mémoire, temps d'exécution maximal, base de données) sont dimensionnées pour le catalogue prévu. Voir la Configuration requise pour l'hébergement.
[ ] Toutes les entrées de la Liste de contrôle de pré-installation sont confirmées.
[ ] Car Market Hub → System & Help n'affiche aucun badge rouge.

2. Configuration de l'extension

[ ] La licence a été activée dans Car Market Hub → Settings (carte License Activation). Les onglets d'administration de l'extension n'affichent plus l'écran « License required », confirmant que les zones premium sont déverrouillées. Voir la Première configuration.
[ ] Les réglages principaux de l'extension dans Car Market Hub → Settings ont été enregistrés et reflètent l'environnement de production, et non de pré-production (staging).
[ ] L'API Base URL, le Seller ID (un ou plusieurs), le Client ID et le Client Secret sont renseignés dans Settings.
[ ] La devise par défaut correspond à la devise de tarification du concessionnaire.
[ ] Les options d'image (importer ou non les images, nombre maximal d'images par véhicule, conversion WebP facultative et qualité) sont définies délibérément et ne sont pas laissées aux valeurs par défaut non vérifiées.
[ ] L'état par défaut des publications et l'auteur par défaut des publications pour les véhicules nouvellement importés sont appropriés pour la production.
[ ] L'option Default pages est soit activée (de sorte que les pages Cars, Compare Cars et Favorites soient créées), soit gérée explicitement par les propres pages de la concession à l'aide des shortcodes documentés.
[ ] Les filtres, les mappings, le design et les styles, ainsi que toutes les personnalisations de mise en page ont été vérifiés sur de vraies données de véhicules importés — et non sur du contenu fictif.

3. Connexion API

[ ] Le test de connexion API dans Car Market Hub → Tools se termine avec succès sur le site de production, avec les identifiants API de production. Voir le Connection Test.
[ ] Si plusieurs Seller IDs sont configurés, une simulation (Dry Run) a été exécutée depuis Tools et renvoie des données pour chaque Seller ID configuré.
[ ] Aucune erreur d'authentification, d'autorisation ou SSL n'apparaît dans Car Market Hub → Logs pour le test de connexion et la simulation les plus récents.
[ ] Les identifiants en production ne sont pas les mêmes valeurs temporaires utilisées lors des premiers tests de pré-production ; les identifiants de production renouvelés, le cas échéant, ont été testés à nouveau.

4. Importations de test et qualité des données

[ ] Au moins une importation manuelle d'un seul véhicule via Car Market Hub → Car Importer a réussi, y compris les pièces jointes d'images.
[ ] Une importation manuelle complète via le Batch-Wizard dans Car Market Hub → Import & Limits s'est terminée sans erreur. Le Batch-Wizard prend en charge la pause, la reprise et l'annulation si nécessaire.
[ ] Le nombre de véhicules importés correspond aux attentes pour les Seller IDs configurés (à vérifier par rapport à l'inventaire AutoScout24 du concessionnaire).
[ ] Un échantillon représentatif de véhicules importés a été examiné pour : le titre, le prix, la devise, le kilométrage, la liste des équipements, le nombre d'images et l'ordre des images.
[ ] La synchronisation complète (Full Sync) est activée uniquement après que l'importation de test a confirmé que tous les véhicules attendus arrivent correctement. La Full Sync supprime définitivement les publications de véhicules locales et leurs images pour toute annonce qui n'est plus renvoyée par l'API.

5. Planification et traitement en arrière-plan

[ ] L'intervalle d'importation automatique souhaité (toutes les heures, toutes les 6 heures, deux fois par jour, quotidiennement ou personnalisé) a été choisi et reflète les attentes de rafraîchissement des données du concessionnaire.
[ ] Si WP-Cron n'est pas fiable sur l'hébergeur (par exemple parce que les visites de pages sont trop rares ou que l'hébergeur limite le cron interne), une tâche cron réelle du serveur est configurée sur le point de terminaison REST sécurisé par jeton de l'extension. Voir la Configuration du cron du serveur et Cron et traitement en arrière-plan.
[ ] La file d'attente des images est activée pour maintenir les exécutions de cron dans les limites des délais d'expiration PHP sur les grands catalogues. L'état de la file d'attente dans System & Help montre une progression saine après l'importation de test.
[ ] Les paramètres de robustesse du cron (nombre maximal de véhicules par exécution de cron) sont dimensionnés pour le catalogue et les limites d'exécution PHP de l'hébergeur.
[ ] Le comportement du cache des jetons a été vérifié : un nouveau test après le renouvellement des identifiants réussit (en vidant le cache des jetons depuis Tools si nécessaire).

6. Frontend et expérience client

[ ] La page d'archive Cars s'affiche correctement avec de réels véhicules, y compris les filtres, la pagination, le tri et les miniatures d'images.
[ ] Au moins une page de véhicule unique a été examinée de bout en bout : galerie, tableau des détails du véhicule, liste des équipements, formatage du prix, formulaire de contact (avec la case à cocher de consentement) et toutes les fonctionnalités facultatives (calculateur de financement, formulaire de demande d'essai, partage social) qui sont activées.
[ ] Une soumission de formulaire de contact de test apparaît sous Car Market Hub → Leads et déclenche l'e-mail du destinataire configuré.
[ ] Si les alertes de recherche sont activées, un abonnement de test a été effectué, y compris l'e-mail de confirmation Double-Opt-In. Voir le Double Opt-In des alertes de recherche.
[ ] Si l'Assistant IA est activé, les contenus générés par l'IA sur au moins un véhicule ont été examinés et sont acceptables pour la publication.
[ ] Les traductions / chaînes de langue sur le frontend reflètent la langue du site ; les chaînes manquantes ont été traitées via le flux de travail de traduction standard de WordPress. Voir le Guide de traduction et PoEdit.

7. Aspects juridiques, confidentialité et consentement

[ ] Le site dispose d'une politique de confidentialité publiée qui couvre les données collectées par l'extension (données du formulaire de contact, événements d'analyse facultatifs, abonnements facultatifs aux alertes de recherche). Voir les Notes sur le RGPD / DSGVO et l'Aperçu du stockage des données.
[ ] Le libellé de la case à cocher de consentement du formulaire de contact, son état obligatoire et les champs visibles sous Car Market Hub → Leads correspondent à la politique de confidentialité du concessionnaire. Voir les Données de leads et consentement.
[ ] Si la réservation d'essais routiers est activée, les jours de la semaine disponibles, la plage horaire quotidienne, la durée des créneaux et les dates d'exclusion reflètent la disponibilité réelle de la concession.
[ ] La concession a accepté que les données de leads et d'alertes de recherche importées soient stockées dans la base de données WordPress et est responsable de toutes les obligations de conservation ou d'exportation en vertu de la loi applicable.

8. Performance, mise en cache et SEO

[ ] Tout cache de page ou d'objet (cache côté serveur, CDN, extension de mise en cache) a été configuré de manière à ce que les pages d'archives de véhicules et de véhicules uniques affichent des données fraîches après chaque importation, et à ce que les requêtes d'administration ne soient pas servies depuis le cache.
[ ] Si un CDN sert des images à partir de wp-content/uploads/, des purges d'images ou des durées de vie de cache courtes sont en place afin que les images nouvellement importées deviennent visibles rapidement.
[ ] Le site est accessible sur le domaine de production final via HTTPS, et les options d'adresse du site / adresse WordPress de WordPress pointent vers ce domaine.
[ ] Le site n'est pas configuré sur « Demander aux moteurs de recherche de ne pas indexer ce site » (sauf si c'est l'intention explicite de la concession).
[ ] Un sitemap XML existe (fourni par le cœur de WordPress ou par une extension SEO) et les nouvelles URL des véhicules suivent la structure canonique de la concession.
[ ] Aucune URL de pré-production, adresse e-mail de test ou texte de consentement de test ne subsiste dans la configuration de production.

9. Opérations, surveillance et support

[ ] Car Market Hub → Logs a été ouvert et le comportement de rotation est compris. Le répertoire des journaux wp-content/uploads/as24ci-logs/ est accessible en écriture. Voir Journalisation et surveillance.
[ ] Un calendrier pour les vérifications de routine a été convenu avec le client : examen quotidien des leads et des importations (Fonctionnement quotidien), Maintenance hebdomadaire et Maintenance mensuelle.
[ ] La Surveillance des importations et la Maintenance de la file d'attente des images sont comprises par la personne qui exploitera le site.
[ ] Une procédure de sauvegarde et de restauration est documentée et a été testée au moins une fois. Voir Sauvegarde et restauration.
[ ] Le canal de mise à jour de l'extension est convenu (téléversement par l'administrateur d'un nouveau fichier ZIP, ou remplacement du dossier de l'extension par SFTP) et correspond au Processus de mise à jour.
[ ] Un plan de retour arrière documenté existe : comment désactiver la planification, comment désactiver l'extension sans perdre de données, et comment restaurer à partir d'une sauvegarde si nécessaire.
[ ] L'exploitation quotidienne a été déléguée aux utilisateurs appropriés via les rôles et capacités de l'extension. Voir Contrôle d'accès et capacités.
[ ] Les canaux de contact pour le support sont documentés du côté du client : qui gère les problèmes WordPress, qui gère l'hébergement, qui possède le compte API AutoScout24, et comment remonter les informations à AD Promotion si nécessaire.
[ ] Les informations nécessaires pour ouvrir un ticket de support sont connues à l'avance. Voir la Liste de contrôle des informations de support.

10. Actions finales de mise en production

Uniquement après que chaque élément applicable ci-dessus a été coché :

Exécutez à nouveau le test de connexion sur le site de production comme ultime vérification de bon fonctionnement.
Activez les importations automatiques dans Car Market Hub → Import & Limits avec l'intervalle choisi.
Déclenchez une importation manuellement (ou attendez la première exécution planifiée) et surveillez les journaux jusqu'à ce qu'elle se termine.
Vérifiez à nouveau le frontend sur le domaine de production, y compris une réelle soumission de formulaire de contact et, le cas échéant, un réel abonnement aux alertes de recherche.
Passez le relais à la routine de surveillance convenue et informez le client que les importations sont désormais actives.

Référence de configuration

Ce document n'introduit pas de nouveaux réglages ; il fait uniquement référence à la configuration documentée ailleurs. Les pages les plus pertinentes sont :

Champs de connexion API : voir la Configuration des identifiants API.
Planification et limites d'importation : voir la Première configuration (Étape 5) et Cron et traitement en arrière-plan.
Champs de leads et de consentement : voir les Données de leads et consentement.
Cron du serveur et déclencheurs externes : voir la Configuration du cron du serveur.

Notes opérationnelles

Réversibilité. La désactivation de la planification automatique dans Importations et limites arrête les nouvelles importations sans supprimer les véhicules déjà importés. 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. Les données ne sont supprimées lors de la désinstallation que si le paramètre de nettoyage correspondant est activé. Voir Désinstallation et nettoyage des données.
Full Sync au lancement. Il est généralement plus sûr de lancer le site avec Full Sync désactivé, d'observer un cycle d'importation complet, et d'activer Full Sync uniquement une fois que l'inventaire importé est systématiquement complet. L'activation prématurée de Full Sync peut supprimer définitivement des véhicules qui étaient simplement absents d'une réponse API temporaire. Vérifiez ce comportement dans la version actuelle de l'extension avant de publier en cas de doute.
Changements de domaine et d'URL. Si le site est lancé sur un nouveau domaine (par exemple en passant de staging.example.com à www.example.com), assurez-vous que les URL WordPress, toute couche de cache et tout service externe qui pointe vers le site sont alignés avant d'activer les importations. Voir Migration de staging vers production.
Lancements discrets. Pour les lancements sensibles, envisagez d'activer les importations automatiques en dehors des heures de bureau et de surveiller le premier cycle cron via la vue Journaux avant que les clients ne puissent accéder aux nouvelles pages.
Remise de la documentation. Fournissez au client les pages pertinentes du Manuel de l'utilisateur et de la section Opérations et maintenance, afin qu'il comprenne le flux de travail quotidien dont il prend la responsabilité.

Dépannage

Symptôme à la mise en production	Cause probable	Ce qu'il faut vérifier
Le test de connexion échoue en production mais a réussi en staging.	Les identifiants de production diffèrent, le réseau de production est plus restrictif, ou le serveur de production a un bundle CA différent.	Saisissez à nouveau les identifiants, confirmez les requêtes HTTPS sortantes vers l'hôte de l'API avec l'hébergeur, et examinez les erreurs SSL. Voir Test de connexion et Erreurs de connexion API.
Les importations planifiées ne démarrent pas après l'activation de la planification.	WP-Cron est désactivé ou limité sur l'hébergement.	Configurez une tâche cron système (serveur) pointant vers le point de terminaison REST de l'extension. Voir Configuration du cron serveur et Erreurs de cron.
La première importation en production supprime des véhicules qui devraient encore exister.	Full Sync a été activé avant que l'inventaire importé ne soit confirmé comme complet.	Désactivez Full Sync, restaurez les véhicules concernés à partir d'une sauvegarde, et ne réactivez Full Sync qu'après avoir observé un cycle d'importation complet et réussi.
Les pages de véhicules s'affichent sans images, ou les images apparaissent progressivement.	La file d'attente des images est en cours de traitement en arrière-plan (comportement attendu) ou des dépassements de temps PHP (timeouts) interrompent les téléchargements.	Surveillez l'état de la file d'attente des images dans Système & Aide ; déclenchez Lancer la file d'attente des images maintenant. Voir Erreurs d'importation d'images et Maintenance de la file d'attente des images.
Les e-mails de leads ne sont pas livrés.	Le site ne peut pas envoyer d'e-mails, l'adresse du destinataire est incorrecte, ou l'hébergeur bloque le SMTP sortant.	Vérifiez l'adresse e-mail du destinataire sous Leads et la configuration de messagerie sortante du site. Voir Erreurs d'e-mail et de lead.
Les pages mises en cache continuent d'afficher l'ancien inventaire de véhicules.	Le cache de page ou le CDN sert du contenu obsolète.	Configurez l'invalidation du cache ou des durées de vie (TTL) plus courtes pour les URL concernées.
Les visiteurs atterrissent sur les URL de staging après le lancement.	Liens obsolètes, URL de site WordPress incorrecte, ou propagation DNS non finalisée.	Confirmez les options WordPress Adresse du site et Adresse de WordPress, et vérifiez la propagation DNS pour le domaine de production.

Pour des diagnostics plus larges basés sur les symptômes, consultez la section Dépannage.