Documentation · Opérations et maintenance
Désinstallation et nettoyage des données
Ce document décrit ce qui se passe lorsque l'extension ADP Car Market Hub est désactivée ou désinstallée, quelles données sont supprimées, quelles données sont conservées et comment contrôler le comportement de nettoyage. Il couvre également les risques et les options de récupération.
Quand utiliser ce document
Lisez ce document avant de désinstaller l'extension d'un site de production. C'est particulièrement important si vous souhaitez conserver les données de véhicules importés, les leads ou les analyses après la suppression de l'extension, ou si vous devez comprendre ce qui sera supprimé automatiquement.
Aperçu
La routine de désinstallation de l'extension est exécutée lorsqu'un administrateur supprime l'extension via l'administration WordPress → Extensions → Supprimer. La routine est définie dans uninstall.php et s'exécute dans le contexte de l'administration WordPress.
Le simple fait de désactiver l'extension ne supprime aucune donnée. La suppression des données ne se produit que lorsque l'extension est supprimée (et pas seulement désactivée).
La routine de désinstallation distingue :
- Les éléments qui sont toujours supprimés — quel que soit le réglage
- Les éléments qui sont supprimés sous condition — uniquement si l'option Supprimer les données lors de la désinstallation est activée
- Les éléments qui ne sont jamais supprimés par la routine de désinstallation
Ce qui est toujours supprimé lors de la désinstallation
Les éléments suivants sont toujours supprimés lorsque l'extension est retirée, quel que soit le réglage de Supprimer les données lors de la désinstallation :
| Élément | Détails |
|---|---|
| Toutes les options de l'extension | Toutes les lignes wp_options avec des clés préfixées par as24ci_, y compris les identifiants API, les réglages d'importation, la configuration de la planification, les réglages de design, les réglages du formulaire de lead et les réglages d'analyse |
Table de base de données : {prefix}as24ci_analytics | Supprimée sans condition car elle contient les données de suivi des visiteurs et ne doit pas persister après la suppression de l'extension |
Table de base de données : {prefix}as24_vehicles | Supprimée sans condition (données des champs de véhicules utilisées pour l'affichage et la recherche) |
Table de base de données : {prefix}as24ci_search_agents | Supprimée sans condition car elle contient des données personnelles (nom de l'abonné, e-mail, préférences de recherche) |
Table de base de données : {prefix}as24ci_content_studio_jobs | Supprimée sans condition (enregistrements des tâches de génération de contenu par l'IA du Content Studio) |
Table de base de données : {prefix}as24ci_content_studio_assets | Supprimée sans condition (ressources marketing générées par le Content Studio : légendes, hashtags, textes alternatifs, références d'images) |
| Options de version de schéma | as24ci_vehicles_db_version, as24ci_search_agent_db_version et as24ci_content_studio_db_version sont supprimées en même temps que leurs tables |
| Événements WP-Cron | La planification de as24ci_scheduled_import et as24ci_daily_cleanup est annulée |
| Transients | as24ci_access_token, as24ci_cron_import_running, as24ci_image_queue_running sont supprimés |
Ces suppressions ne peuvent pas être annulées. Si vous devez conserver des données d'analyse ou des données de champs de véhicules, exportez-les de la base de données avant de procéder à la désinstallation.
Ce qui est supprimé sous condition lors de la désinstallation
Les éléments suivants ne sont supprimés que si l'option Supprimer les données lors de la désinstallation (as24ci_delete_data_on_uninstall) est définie sur 1 (activée) :
| Élément | Détails |
|---|---|
Publications de véhicules (CPT : as24ci_car) | Toutes les publications du type de publication personnalisé as24ci_car, quel que soit leur état (publié, brouillon, corbeille), sont définitivement supprimées |
| Images de véhicules importées | Les pièces jointes suivies dans les métadonnées de publication _as24ci_image_ids pour chaque publication de véhicule sont définitivement supprimées de la médiathèque WordPress |
| Images mises en avant | Si l'image mise en avant de la publication du véhicule est une pièce jointe importée, elle est également supprimée |
Publications de leads (CPT : as24ci_lead) | Toutes les publications du type de publication personnalisé as24ci_lead sont définitivement supprimées |
| Pages créées à l'activation | La page d'archive, la page de comparaison et la page des favoris créées par l'extension lors de l'activation (ID stockés dans as24ci_page_archive_id, as24ci_page_compare_id et as24ci_page_favorites_id) sont définitivement supprimées |
Si cette option est désactivée (par défaut), toutes les publications de véhicules, les images et les leads restent dans la base de données et la médiathèque WordPress après la suppression de l'extension. Ils ne seront plus accessibles via l'interface d'administration de l'extension, mais les données WordPress sous-jacentes sont conservées.
Ce qui n'est jamais supprimé
Les éléments suivants ne sont pas supprimés par la routine de désinstallation, quels que soient les réglages :
| Élément | Détails |
|---|---|
| Images de galerie téléversées manuellement | Les pièces jointes suivies dans _as24ci_manual_image_ids (images ajoutées manuellement via la médiathèque WordPress, non importées depuis AutoScout24) ne sont jamais supprimées |
| Comptes d'utilisateurs WordPress | Tous les utilisateurs auxquels la capacité manage_as24_imports a été accordée conservent cette entrée de capacité dans les métadonnées d'utilisateur WordPress |
| Fichiers journaux | Le répertoire {uploads}/as24ci-logs/ et son contenu ne sont pas supprimés par la routine de désinstallation. Supprimez-les manuellement via SFTP ou le gestionnaire de fichiers de l'hébergement si nécessaire |
| Données mises en cache restantes dans le cache d'objets | Les caches d'objets externes (tels que Redis ou Memcached) peuvent conserver les données de transients liées à l'extension jusqu'à ce qu'elles expirent naturellement |
Comment contrôler le comportement de nettoyage
L'option Supprimer les données lors de la désinstallation se trouve dans l'onglet Réglages de l'extension.
- Ouvrez ADP Car Market Hub → Réglages.
- Trouvez le commutateur ou la case à cocher Supprimer les données lors de la désinstallation.
- Activez-le si vous souhaitez que toutes les publications de véhicules importés, les images, les leads et les pages d'activation soient supprimés lors de la suppression de l'extension.
- Laissez-le désactivé (par défaut) si vous souhaitez conserver le contenu importé après le retrait de l'extension.
Recommandation : Pour un site de test ou de pré-production où les données importées peuvent être jetées, activez cette option avant de désinstaller. Pour un site de production où l'historique d'importation peut être réutilisé ou audité, laissez-la désactivée et gérez la suppression du contenu manuellement.
Comportement en multisite
Sur les installations multisites WordPress, la routine de désinstallation s'exécute une fois par site du réseau. Pour chaque site :
- Si Supprimer les données lors de la désinstallation est activé, les publications de véhicules, les images, les leads et les pages d'activation sont supprimés pour ce site.
- Les tables de base de données personnalisées (
as24ci_analytics,as24_vehicles,as24ci_search_agents,as24ci_content_studio_jobs,as24ci_content_studio_assets) sont supprimées pour ce site (toujours). - Toutes les options de l'extension pour ce site sont supprimées (toujours).
La boucle multisite utilise switch_to_blog() / restore_current_blog() pour traiter chaque site indépendamment.
Étape par étape : désinstallation sécurisée en production
- Effectuez une sauvegarde complète de la base de données et du répertoire des téléversements (uploads) avant de continuer. Voir Sauvegarde et restauration.
- Si vous souhaitez conserver les données des véhicules, laissez Supprimer les données lors de la désinstallation désactivé (par défaut). Si vous souhaitez un nettoyage complet, activez-le maintenant.
- Si vous devez conserver les données d'analyse pour des rapports, exportez la table
{prefix}as24ci_analyticsde la base de données à l'aide de phpMyAdmin, de l'interface CLI WordPress ou de l'outil de base de données de votre hébergeur avant de continuer. Cette table est toujours supprimée lors de la désinstallation. - Accédez à l'administration WordPress → Extensions.
- Désactivez d'abord l'extension, puis cliquez sur Supprimer.
- Confirmez la demande de suppression. La routine de désinstallation s'exécutera automatiquement.
- Vérifiez le résultat : - Accédez à l'administration WordPress → Outils → Base de données (ou un outil de base de données) et confirmez que les tables personnalisées ont disparu. - Si Supprimer les données lors de la désinstallation était activé, vérifiez que la page d'archive des véhicules n'existe plus. - Si les données ont été conservées, confirmez que les publications de véhicules sont toujours présentes dans l'administration WordPress → Articles ou en visitant directement l'URL de l'archive.
- Supprimez manuellement le répertoire des journaux via SFTP s'il n'est plus nécessaire :
{wp-content/uploads}/as24ci-logs/.
Notes opérationnelles et risques
- La table d'analyse (
{prefix}as24ci_analytics) est toujours supprimée lors de la désinstallation sans avertissement, même si Supprimer les données lors de la désinstallation est désactivé. Si vous avez des données d'analyse que vous souhaitez conserver, exportez-les avant de supprimer l'extension. - De même, la table des véhicules (
{prefix}as24_vehicles), la table des agents de recherche ({prefix}as24ci_search_agents) et les deux tables du Content Studio ({prefix}as24ci_content_studio_jobs,{prefix}as24ci_content_studio_assets) sont toujours supprimées. - Les images importées supprimées par la routine de désinstallation sont retirées définitivement du système de fichiers du serveur. Elles ne peuvent pas être récupérées depuis la médiathèque WordPress.
- Si la fonction
get_sites()n'est pas disponible sur une installation multisite, la routine de désinstallation se rabat sur le comportement mono-site et ne traite que le site actuel. - Les clés d'options nettoyées lors de la désinstallation sont dérivées de la classe
Optionsau moment de l'exécution, de sorte que la liste est toujours à jour avec la version installée de l'extension. Une liste codée en dur de secours est utilisée si la classeOptionsne peut pas être chargée. - La désactivation de l'extension sans la supprimer n'exécute pas la routine de désinstallation. Aucune donnée n'est supprimée lors de la désactivation. L'extension peut être réactivée à tout moment et reprendra son fonctionnement normal.
Dépannage
| Symptôme | Cause probable | Action à vérifier |
|---|---|---|
| Les publications de véhicules sont toujours présentes après la désinstallation | Delete data on uninstall était désactivé (par défaut) | Comportement attendu ; supprimez les publications manuellement ou réactivez l'option et supprimez à nouveau |
| Données d'analyse manquantes après la désinstallation | La table d'analyse est toujours supprimée lors de la désinstallation | Exportez la table avant de supprimer l'extension |
| Fichiers journaux toujours présents après la désinstallation | Les fichiers journaux ne sont pas supprimés par la routine de désinstallation | Supprimez le répertoire as24ci-logs/ manuellement via SFTP |
| Images téléversées manuellement supprimées | Vérifiez qu'elles ont été ajoutées via _as24ci_manual_image_ids, et non importées via _as24ci_image_ids | Si elles ont été supprimées accidentellement, restaurez-les à partir d'une sauvegarde |
| Les options de l'extension sont toujours présentes après la désinstallation | La routine de désinstallation ne s'est pas terminée (erreur PHP lors de la suppression) | Vérifiez le journal des erreurs PHP ; déclenchez à nouveau en réinstallant puis en supprimant à nouveau |
| Tables personnalisées toujours présentes dans la base de données | La routine de désinstallation a rencontré une erreur de permission de base de données | Exécutez DROP TABLE IF EXISTS {prefix}as24ci_analytics manuellement |