Documentation · System Requirements

Liste de contrôle de pré-installation

Objectif

Cette liste de contrôle regroupe tout ce qu'une agence ou un administrateur doit vérifier avant d'installer ADP Car Market Hub ou avant de basculer une installation de staging en production. Elle est volontairement pratique : chaque élément correspond à une vérification concrète qui peut être effectuée en quelques minutes sur l'environnement d'hébergement, le site WordPress ou le compte AutoScout24.

Quand utiliser ce document

Utilisez ce document lorsque vous :

Intégrez un nouveau concessionnaire et avez besoin d'une page unique pour valider son hébergement avant d'installer l'extension.
Transférez un site fraîchement créé du staging vers la production.
Auditez une installation existante qui fonctionne depuis un certain temps et qui a pu s'écarter de la configuration de référence recommandée.
Remettez un site à une autre agence ou à l'équipe informatique interne du client.

Aperçu

La liste de contrôle est regroupée en neuf domaines. Chaque domaine comporte un petit nombre d'éléments oui/non. Considérez tout « non » comme un élément bloquant pour les importations en production jusqu'à ce qu'il soit résolu ou explicitement toléré.

Pour plus de détails sur un élément, suivez le lien dans la section Documents connexes en bas de cette page.

Liste de contrôle

1. Hébergement et environnement d'exécution

[ ] PHP 8.1 ou plus récent est installé et actif pour le site WordPress.
[ ] Le paramètre PHP memory_limit est d'au moins 256 Mo (128 Mo est le minimum absolu accepté par l'onglet Système & Aide).
[ ] Le paramètre PHP max_execution_time est d'au moins 120 secondes ; 300 secondes sont recommandées pour les importations volumineuses en images.
[ ] Les extensions PHP openssl, curl, mbstring, json et l'une des extensions gd / imagick sont chargées ; ZipArchive est disponible pour les lots d'exportation.
[ ] Au moins 1 Go d'espace disque libre est disponible sur le volume qui héberge wp-content/uploads/ ; prévoyez 5 à 25 Mo par véhicule pour les médias.
[ ] Le serveur web utilise Nginx, Apache ou un autre serveur pris en charge par WordPress avec la réécriture d'URL activée.

2. WordPress

[ ] WordPress 6.2 ou plus récent est installé.
[ ] HTTPS est actif sur le site public avec un certificat valide.
[ ] Les permaliens sont configurés sur une option autre que « Simple » (requis pour le point de terminaison REST du cron et les jolies URL d'archives).
[ ] Un compte administrateur est disponible pour l'installation et la configuration.
[ ] Aucune extension conflictuelle d'AutoScout24 / d'importation de véhicules n'est active.
[ ] Un environnement de staging existe avec les mêmes versions de PHP/MySQL que la production.

3. Base de données

[ ] MySQL 5.7+ ou MariaDB 10.3+ (correspondant aux minimums d'WordPress) est utilisé, avec utf8mb4 comme jeu de caractères par défaut.
[ ] L'utilisateur de la base de données WordPress dispose des privilèges CREATE, ALTER, INDEX, DROP, INSERT, UPDATE, DELETE et SELECT afin que l'activation puisse exécuter dbDelta() pour les tables personnalisées de l'extension.
[ ] Des sauvegardes quotidiennes de la base de données sont configurées et ont été testées en restauration au moins une fois.

4. Réseau, API et SSL

[ ] Le trafic HTTPS sortant (TCP/443) est autorisé depuis le serveur web vers l'hôte API AutoScout24 configuré (par exemple api.autoscout24.com, api.autoscout24.ch, …) et vers les hôtes CDN d'images AutoScout24.
[ ] La résolution DNS depuis le serveur web lui-même fonctionne pour les noms d'hôte AutoScout24.
[ ] Le bundle CA du système est à jour ; l'interception TLS sortante (le cas échéant) installe son autorité de certification racine d'entreprise dans le magasin de confiance du système.
[ ] Si un proxy HTTP sortant est requis, les constantes WP_PROXY_* sont définies dans wp-config.php.
[ ] Si la génération par IA est utilisée, le trafic HTTPS sortant vers generativelanguage.googleapis.com est autorisé. Les fonctionnalités d'IA utilisent la configuration gérée de Google Gemini dans ADP Car Market Hub — aucun fournisseur, modèle ou clé API n'a besoin d'être saisi dans le back-office de WordPress ; l'approvisionnement de l'IA spécifique au client est finalisé par AD Promotion après l'installation.

5. Licence et compte AutoScout24

[ ] La clé de licence ADP Car Market Hub fournie par AD Promotion est à disposition. La licence est requise pour déverrouiller les zones premium de l'extension après l'activation ; sans elle, chaque onglet d'administration, à l'exception de Réglages, affiche un écran « Licence requise ».
[ ] Un compte partenaire AutoScout24 actif avec accès API est en place.
[ ] Le Client ID et le Client Secret ont été émis et stockés de manière sécurisée (gestionnaire de mots de passe ou coffre-fort de secrets).
[ ] Un ou plusieurs Seller IDs sont connus et confirmés comme appartenant au(x) concessionnaire(s) en cours d'intégration.
[ ] L'URL de base de l'API correcte pour le marché du concessionnaire est connue (par exemple https://api.autoscout24.ch pour la Suisse).
[ ] Les adresses IP de sortie du serveur de production ont été partagées avec AutoScout24 si le compte nécessite une liste d'autorisation d'IP.

6. Cron et traitement en arrière-plan

[ ] Une stratégie de cron a été choisie : WP-Cron (acceptable uniquement pour les sites de petite taille ou à fort trafic) ou cron du serveur (recommandé pour la production).
[ ] Si le cron du serveur est choisi, define( 'DISABLE_WP_CRON', true ); a été ajouté à wp-config.php.
[ ] Si le cron du serveur est choisi, deux tâches cron sont prévues : une appelant le point de terminaison REST de l'extension avec le jeton secret (toutes les 15 minutes est une bonne valeur par défaut), et une exécutant wp-cron.php (toutes les 5 minutes) pour maintenir actives la file d'attente des images, le nettoyage des analyses et les autres tâches récurrentes.
[ ] Le jeton secret du cron sera stocké avec les identifiants et renouvelé chaque fois que des collaborateurs ayant accès quittent le projet.
[ ] Des jetons de cron distincts sont prévus pour le staging et la production afin qu'un déclencheur de staging ne puisse pas démarrer une importation de production.

7. E-mail

[ ] Un canal d'e-mails transactionnels fonctionnel est configuré (MTA d'hébergement, extension SMTP pointant vers un fournisseur de délivrabilité, ou relais d'entreprise).
[ ] L'alignement SPF, DKIM et DMARC a été vérifié pour le domaine d'envoi.
[ ] Des e-mails de test (notification de lead, inscription aux alertes de recherche, réinitialisation de mot de passe WordPress) ont été envoyés et reçus.

8. Sauvegardes, surveillance et opérations

[ ] Des sauvegardes quotidiennes hors site couvrent l'intégralité de la base de données WordPress (y compris les tables personnalisées de l'extension préfixées par {wp_prefix}as24_) et l'intégralité du répertoire wp-content/uploads/, avec au moins 7 jours de rétention (30+ jours recommandés).
[ ] La restauration des sauvegardes a été testée au moins une fois.
[ ] Une surveillance de la disponibilité (uptime) est configurée sur l'URL de l'archive publique.
[ ] Une surveillance de la disponibilité ou de la réussite est configurée sur le point de terminaison du déclencheur cron lorsque le cron du serveur est utilisé.
[ ] Une alerte d'espace disque est configurée pour le volume hébergeant wp-content/uploads/.
[ ] Un contact d'astreinte et une procédure d'escalade documentée existent pour les incidents de production.

9. Validation avant lancement dans WordPress

[ ] L'extension est installée et activée sur le staging.
[ ] La licence est activée dans Réglages → Activation de la licence afin que les autres onglets d'administration soient déverrouillés (pas d'écran « Licence requise »).
[ ] Les réglages sont complétés : URL de base de l'API, URL du jeton (si nécessaire), Client ID, Client Secret, Seller ID(s).
[ ] L'onglet Outils → Tester la connexion renvoie un succès.
[ ] L'onglet Système & Aide / Santé affiche des indicateurs verts pour PHP, la base de données, l'espace disque, le cron, l'API et (si configuré) l'AI Assistant.
[ ] Une petite importation via l'assistant de lot (Batch-Wizard) a produit les publications de véhicules, les taxonomies et les médias attendus.
[ ] Les pages de véhicules individuels et l'archive s'affichent correctement avec le thème actif.
[ ] Un lead de test et un abonnement de test aux alertes de recherche ont été soumis et les e-mails correspondants ont été reçus.
[ ] Le mode cron, la planification, la limite de véhicules par exécution et la file d'attente des images ont été finalisés dans l'onglet Importations et limites.
[ ] Une importation s'est déroulée de bout en bout via le déclencheur équivalent à la production (cron du serveur ou alternative choisie).
[ ] La même liste de contrôle a été re-validée sur la production après le déploiement.

Validation finale

Avant d'activer les importations en production, confirmez que chaque élément ci-dessus est coché ou formellement accepté comme une limitation connue, et enregistrez :

Qui a effectué les vérifications et à quelle date.
La version de l'extension installée (voir la page des extensions de WordPress).
Les versions de PHP, d'WordPress et de base de données utilisées.
Le mode cron et la planification configurés.
Le propriétaire des identifiants AutoScout24 et du jeton secret du cron.

Un simple fichier texte ou une page wiki contenant ces informations est suffisant et simplifie considérablement les demandes d'assistance ultérieures.