Sauvegarde et restauration

Ce document explique quelles données l'extension ADP Car Market Hub crée ou gère, quels composants doivent être inclus dans une sauvegarde et comment restaurer un site dans un état fonctionnel après une panne ou une migration.

Quand utiliser ce document

Lisez ce document si vous êtes un administrateur de site, un ingénieur d'hébergement ou un développeur WordPress responsable de la stratégie de sauvegarde et de la reprise après sinistre sur un site exécutant l'extension. Consultez-le avant d'effectuer une mise à jour de l'extension, une migration de serveur ou tout changement de configuration important.

Aperçu

L'extension stocke des données dans plusieurs emplacements au sein de l'installation WordPress. Une sauvegarde complète et restaurable doit inclure tous ces composants. L'extension elle-même ne fournit pas ses propres outils de sauvegarde ; les sauvegardes dépendent de l'approche de sauvegarde standard de WordPress utilisée par votre hébergeur ou votre extension de sauvegarde.

Les annonces de véhicules importées peuvent être réimportées depuis AutoScout24 en cas de perte, mais uniquement si une connexion API valide est disponible. La configuration de l'extension, les leads, les données d'analyse et les fichiers journaux ne peuvent pas être récupérés depuis AutoScout24 et doivent être protégés par la sauvegarde du site.

Ce que l'extension stocke

Configuration requise

• Une solution de sauvegarde WordPress capable de sauvegarder à la fois la base de données et le système de fichiers (dossier des téléversements). Les exemples incluent les instantanés (snapshots) au niveau de l'hébergement, les services de sauvegarde gérés ou les extensions de sauvegarde WordPress. Vérifiez ce comportement et la compatibilité avec votre environnement actuel.
• Un accès en écriture à l'environnement de préproduction (staging) ou de récupération pour tester la restauration.
• La même version de PHP et la même version de WordPress que la production lors de la restauration vers un environnement de test, afin d'éviter les problèmes de compatibilité.

Procédure de sauvegarde

Sauvegarde de la base de données

1. Sauvegardez l'intégralité de la base de données WordPress. Cela capture wp_options (réglages de l'extension), wp_posts et wp_postmeta (articles d'ancrage des véhicules et leads), ainsi que toutes les tables personnalisées gérées par l'extension ({prefix}as24_vehicles, {prefix}as24ci_analytics, {prefix}as24ci_search_agents, {prefix}as24ci_content_studio_jobs, {prefix}as24ci_content_studio_assets).
2. Utilisez un outil de sauvegarde ou un instantané d'hébergement qui exporte un dump SQL complet. Les sauvegardes partielles qui n'incluent que certaines tables sélectionnées peuvent omettre les tables personnalisées.
3. Sur les installations multisites WordPress, chaque site du réseau possède son propre ensemble de tables {prefix}_{siteid}_. Confirmez que votre outil de sauvegarde capture toutes les tables du site.

Sauvegarde des fichiers

1. Sauvegardez le répertoire WordPress wp-content/uploads/. Celui-ci contient : - Toutes les images de véhicules importées (attachées aux articles de véhicules). - Le répertoire des journaux de l'extension : as24ci-logs/. Ce répertoire est protégé contre l'accès public par un fichier .htaccess ; confirmez que votre outil de sauvegarde capture les fichiers cachés.
2. Sauvegardez le répertoire de l'extension wp-content/plugins/adp-car-market-hub/ si vous avez apporté des modifications personnalisées au niveau des fichiers (par exemple, des surcharges de modèles personnalisés). Notez que le répertoire de l'extension lui-même est normalement remplacé lors des mises à jour et ne doit pas être le lieu principal pour les personnalisations.

Note sur la configuration

Les identifiants API de l'extension (Client ID, Client Secret) sont stockés dans les options WordPress et sont inclus dans la sauvegarde de la base de données. Ce sont des valeurs sensibles. Assurez-vous que les fichiers de sauvegarde de la base de données sont stockés de manière sécurisée et que leur accès est restreint.

Procédure de restauration

Restauration complète du site

1. Restaurez la base de données à partir de la sauvegarde en utilisant le panneau de contrôle de votre hébergement, phpMyAdmin ou un client MySQL en ligne de commande.
2. Restaurez le répertoire wp-content/uploads/ à partir de la sauvegarde des fichiers.
3. En cas de restauration sur un nouveau serveur ou domaine, mettez à jour l'URL du site WordPress dans la base de données (wp_options lignes siteurl et home) en utilisant le CLI WordPress (wp option update) ou en modifiant directement la base de données.
4. Videz tout cache d'objet WordPress après la restauration.
5. Connectez-vous à l'administration WordPress et accédez à ADP Car Market Hub → Référence du système et de l'aide pour vérifier l'état de la connexion API.
6. Ouvrez ADP Car Market Hub → Référence des importations et des limites et confirmez que le calendrier d'importation est actif.
7. Déclenchez une importation manuelle depuis l'onglet Référence des importations et des limites et vérifiez que les véhicules sont créés ou mis à jour correctement.

Restauration partielle : réglages uniquement

Si seuls les réglages de l'extension doivent être restaurés (par exemple, après une mauvaise configuration accidentelle) :

1. Importez la sauvegarde de la base de données dans une base de données temporaire ou de préproduction.
2. Extrayez les lignes wp_options concernées avec les clés préfixées par as24ci_ à l'aide d'une requête SQL ou d'un outil de comparaison de bases de données.
3. Appliquez les valeurs d'option récupérées à la base de données de production.
4. Testez la connexion et le pipeline d'importation avant de confirmer que la restauration est terminée.

Restauration des images de véhicules uniquement

Si des images de véhicules ont été supprimées accidentellement de la médiathèque :

1. Restaurez la sauvegarde des fichiers wp-content/uploads/ pour récupérer les fichiers d'images d'origine.
2. Alternativement, relancez l'importation avec l'importation d'images activée. L'importateur vérifie les URL sources des pièces jointes existantes (métadonnées d'article _as24ci_source_url) et ignore les images déjà présentes. Les images manquantes seront retéléchargées depuis AutoScout24.

Notes opérationnelles

• L'extension ne peut pas gérer ou planifier les sauvegardes de manière indépendante. La responsabilité de la sauvegarde incombe au propriétaire du site, à l'hébergeur ou à une extension de sauvegarde WordPress dédiée.
• La table d'analyse ({prefix}as24ci_analytics) et la table des agents de recherche ({prefix}as24ci_search_agents) contiennent des données personnelles (événements des visiteurs, adresses e-mail des abonnés). Traitez les fichiers de sauvegarde contenant ces tables conformément aux réglementations applicables en matière de protection de la vie privée.
• La table d'analyse est toujours supprimée par la routine de désinstallation de l'extension, même si l'option Supprimer les données lors de la désinstallation est désactivée. Si vous avez l'intention de conserver les données d'analyse lors d'une réinstallation de l'extension, exportez ou préservez la table manuellement avant de désinstaller.
• Les images de véhicules importées par l'extension sont suivies dans les métadonnées d'article sous _as24ci_image_ids. Ces ID lient les articles de véhicules à leurs pièces jointes de la médiathèque. Si ces métadonnées d'article ne sont pas présentes lors d'une restauration, les images peuvent rester dans la médiathèque en tant que pièces jointes orphelines.
• Les fichiers journaux dans as24ci-logs/ ne sont pas critiques pour restaurer les fonctionnalités du site, mais ils peuvent contenir des informations de diagnostic utiles. Si vous devez conserver plus de 7 jours d'historique de journaux, copiez les fichiers journaux archivés vers un stockage à long terme avant que l'extension ne les purge.

Dépannage

Documents connexes

• Processus de mise à jour
• Maintenance mensuelle
• Désinstallation et nettoyage des données
• Journalisation et surveillance