Documentation · Documentation technique

Comportement de désinstallation et de nettoyage

Ce document explique exactement ce qui se passe lorsque le plugin ADP Car Market Hub est supprimé d'un site WordPress, y compris quelles données sont toujours supprimées, quelles données ne sont supprimées que lorsque l'option de nettoyage est activée, et comment les installations multisites sont gérées.

Quand utiliser ce document

Lisez ce document si vous devez :

Planifier une suppression propre du plugin d'un site de production.
Comprendre si la suppression du plugin conservera ou détruira les véhicules importés, les leads ou les réglages.
Auditer la conformité RGPD / protection des données pour la suppression du plugin.
Migrer un site vers un autre plugin et savoir ce qui reste en arrière-plan.

Aperçu

Le plugin est livré avec un script uninstall.php qui WordPress s'exécute automatiquement lorsque le plugin est supprimé depuis Extensions → Extensions installées. Le script :

Supprime toujours les transients du plugin et annule la planification des événements WP-Cron du plugin.
Supprime toujours les tables de base de données personnalisées du plugin, y compris celles contenant des données de visiteurs ou des données personnelles.
Supprime éventuellement les publications créées par le plugin (véhicules, leads, pièces jointes importées, pages créées par le plugin) lorsque le réglage Supprimer les données lors de la désinstallation est activé.
Supprime toujours l'ensemble complet des options du plugin.

L'intention est axée sur la confidentialité par défaut : toutes les données collectées par le plugin sur les visiteurs (événements d'analyse, abonnements aux alertes de recherche) sont supprimées sans condition, tandis que le contenu créé par-dessus les données importées (qu'un client peut souhaiter conserver même après avoir désinstallé l'importateur) n'est supprimé que si le client choisit explicitement de le faire.

Ce qui est toujours supprimé

Quel que soit le réglage Supprimer les données lors de la désinstallation, la procédure de désinstallation effectue les opérations suivantes :

Transients :
as24ci_access_token — jeton d'accès AutoScout24 mis en cache.
as24ci_cron_import_running — verrou d'exécution de l'importation.
as24ci_image_queue_running — verrou du worker de la file d'attente des images.
Événements WP-Cron :
as24ci_scheduled_import — importation planifiée principale.
as24ci_daily_cleanup — nettoyage de la rétention des analyses.
Tables personnalisées :
<prefix>as24ci_analytics — événements de suivi des visiteurs.
<prefix>as24_vehicles — table des données de champs de véhicules.
<prefix>as24ci_search_agents — abonnements aux recherches sauvegardées (contient les adresses e-mail et les critères de recherche).
<prefix>as24ci_content_studio_assets — ressources du Content Studio.
<prefix>as24ci_content_studio_jobs — tâches du Content Studio.
Options de version de schéma :
as24ci_vehicles_db_version.
as24ci_search_agent_db_version.
as24ci_content_studio_db_version.
Options du plugin : chaque clé déclarée par AS24CI\Options::get_all_keys(), plus un petit ensemble de clés non constantes ajoutées explicitement : as24ci_models_cache_keys, as24ci_page_archive_id, as24ci_page_compare_id, as24ci_page_favorites_id, l'ancienne clé as24ci_api_total_cache, et les réglages du Content Studio (as24ci_content_studio_db_version, as24ci_content_studio_google_api_key, as24ci_content_studio_default_language, as24ci_content_studio_default_tone, as24ci_content_studio_brand_voice, as24ci_content_studio_disclaimer_text, as24ci_content_studio_compliance_notes).

Ce qui est supprimé uniquement lorsque l'option est activée

Le réglage as24ci_delete_data_on_uninstall contrôle le nettoyage destructif du contenu créé par le plugin. Lorsqu'il est égal à 1, la procédure de désinstallation effectue en plus :

Parcourt toutes les publications as24ci_car (quel que soit leur statut) et :
Supprime les pièces jointes répertoriées dans _as24ci_image_ids (images importées).
Supprime la pièce jointe de l'image mise en avant de la publication lorsqu'elle est présente.
Supprime la publication du véhicule elle-même avec wp_delete_post( $id, true ).
Supprime toutes les publications as24ci_lead.
Supprime les pages créées lors de l'activation dont les ID sont stockés dans as24ci_page_archive_id, as24ci_page_compare_id et as24ci_page_favorites_id.

Les pièces jointes de galerie manuelles (référencées depuis _as24ci_manual_image_ids) ne sont volontairement pas supprimées. Cela protège les images qu'un client a ajoutées manuellement, même si la publication du véhicule parent est supprimée.

Gestion du multisite

Sur une installation en réseau :

Le script parcourt chaque site renvoyé par get_sites().
Pour chaque site, il switch_to_blog(), exécute le nettoyage destructif (si l'option est activée), supprime les tables d'analyse, de véhicules, d'alertes de recherche et de Content Studio (tâches + ressources) propres au site, supprime les options propres au site et restore_current_blog().
Après avoir traité chaque site, la fonction se termine et n'exécute pas la branche pour site unique.

Vérifiez le chemin multisite par rapport à la configuration des rôles de votre réseau avant de procéder à une désinstallation groupée en production ; le script n'effectue aucune cascade inter-sites au-delà des opérations répertoriées ci-dessus.

Instructions étape par étape

Supprimer le plugin et conserver tout le contenu importé

(Facultatif) Ouvrez les réglages du plugin et confirmez que Supprimer les données lors de la désinstallation est désactivé.
Allez dans Extensions → Extensions installées, désactivez "ADP Car Market Hub", puis cliquez sur Supprimer.
Confirmez la suppression. WordPress exécute uninstall.php. Les publications de véhicules importés et leurs images restent dans la base de données ; les réglages du plugin et les données des visiteurs sont supprimés.

Supprimer le plugin et tout le contenu créé par le plugin

Ouvrez les réglages du plugin.
Activez Supprimer les données lors de la désinstallation.
Enregistrez.
Allez dans Extensions → Extensions installées, désactivez le plugin, puis cliquez sur Supprimer.
Confirmez. WordPress exécute uninstall.php, ce qui supprime les véhicules importés, les pièces jointes importées, les leads et les pages d'archive/comparaison/favoris créées par le plugin.

Référence de configuration

Clé d'option	Effet
`as24ci_delete_data_on_uninstall`	Lorsque `1`, supprime également les publications importées, les pièces jointes importées, les publications de leads et les pages créées par le plugin lors de la désinstallation. Valeur par défaut : `0`.

Pour la liste complète des options du plugin, voir Stockage des options et des réglages.

Notes opérationnelles

La désinstallation s'exécute dans un contexte WordPress spécial avec un chargement initial limité. Le script évite de charger des dépendances lourdes et se montre défensif face aux classes manquantes (une liste d'options codée en dur est utilisée comme solution de secours si AS24CI\Options ne peut pas être chargé).
Les suppressions de tables personnalisées sont émises avec du DROP TABLE IF EXISTS brut sur le nom de table préfixé. Les hébergeurs qui restreignent les privilèges de modification de schéma peuvent générer des avertissements ici ; la suppression est effectuée au mieux et n'interrompt pas la désinstallation.
Les images importées qui sont référencées par d'autres publications (par exemple réutilisées comme images mises en avant dans du contenu non lié) seront tout de même supprimées lorsque le nettoyage optionnel est activé. Auditez la réutilisation des pièces jointes importées avant d'activer cette option.
Les images de galerie manuelles restent dans la bibliothèque de médias WordPress même lorsque le nettoyage optionnel est activé ; supprimez-les séparément si nécessaire.
Les URL de webhook et les secrets partagés sont stockés dans les options du plugin et sont donc supprimés sans condition lors de la désinstallation. Les systèmes externes cesseront de recevoir des événements dès que le plugin sera supprimé.
La simple désactivation (sans suppression) ne lance pas uninstall.php. Elle efface uniquement les événements WP-Cron en attente et actualise les règles de réécriture.

Dépannage

Les véhicules importés restent après la désinstallation — *Supprimer les données lors de la désinstallation* était désactivé lorsque le plugin a été supprimé. Réinstallez temporairement le plugin pour accéder à l'interface d'administration, activez l'option, puis supprimez-le à nouveau. Alternativement, supprimez les publications as24ci_car manuellement avec WP-CLI.
Les tables personnalisées existent toujours après la désinstallation — l'utilisateur de la base de données ne dispose pas des privilèges DROP. Supprimez les tables manuellement avec un compte privilégié.
La désinstallation multisite a laissé des données sur certains sites — confirmez que l'administrateur du réseau a exécuté la suppression. Les désinstallations par site déclenchées par les administrateurs de site ne se propagent pas toujours sur l'ensemble du réseau selon la version de WordPress. Vérifiez le comportement actuel par rapport à votre version de WordPress avant les déploiements à grande échelle.
Les options du plugin réapparaissent après la réinstallation — elles ont été recréées par l'activation. Le nettoyage ne s'exécute que lors de la suppression, pas lors de la désactivation.