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 :

  1. Les éléments qui sont toujours supprimés — quel que soit le réglage
  2. 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
  3. 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émentDétails
Toutes les options de l'extensionToutes 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_analyticsSupprimé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_vehiclesSupprimé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_agentsSupprimé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_jobsSupprimé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_assetsSupprimé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émaas24ci_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-CronLa planification de as24ci_scheduled_import et as24ci_daily_cleanup est annulée
Transientsas24ci_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émentDé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éesLes 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 avantSi 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'activationLa 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émentDétails
Images de galerie téléversées manuellementLes 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 WordPressTous 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 journauxLe 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'objetsLes 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.

  1. Ouvrez ADP Car Market Hub → Réglages.
  2. Trouvez le commutateur ou la case à cocher Supprimer les données lors de la désinstallation.
  3. 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.
  4. 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 :

  1. 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.
  2. 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).
  3. 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

  1. 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.
  2. 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.
  3. Si vous devez conserver les données d'analyse pour des rapports, exportez la table {prefix}as24ci_analytics de 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.
  4. Accédez à l'administration WordPress → Extensions.
  5. Désactivez d'abord l'extension, puis cliquez sur Supprimer.
  6. Confirmez la demande de suppression. La routine de désinstallation s'exécutera automatiquement.
  7. 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.
  8. 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 Options au 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 classe Options ne 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ômeCause probableAction à vérifier
Les publications de véhicules sont toujours présentes après la désinstallationDelete 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ésinstallationLa table d'analyse est toujours supprimée lors de la désinstallationExportez la table avant de supprimer l'extension
Fichiers journaux toujours présents après la désinstallationLes fichiers journaux ne sont pas supprimés par la routine de désinstallationSupprimez le répertoire as24ci-logs/ manuellement via SFTP
Images téléversées manuellement suppriméesVérifiez qu'elles ont été ajoutées via _as24ci_manual_image_ids, et non importées via _as24ci_image_idsSi 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ésinstallationLa 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éesLa routine de désinstallation a rencontré une erreur de permission de base de donnéesExécutez DROP TABLE IF EXISTS {prefix}as24ci_analytics manuellement

Documents connexes