Documentation · Référence de l'administrateur

Référence de l'assistant de configuration

Ce document est une référence pour l'Assistant de première configuration de l'extension ADP Car Market Hub. L'assistant est un flux d'intégration de style entreprise en six étapes qui aide un administrateur WordPress à effectuer les tâches de configuration les plus courantes immédiatement après la première activation.

L'assistant est facultatif. Chaque option qu'il propose peut également être configurée manuellement à l'aide des onglets d'administration habituels documentés ailleurs dans la Référence de l'administrateur. Pour l'ordre de configuration complet recommandé, voir Première configuration.

Quand utiliser ce document

Lisez ceci si vous devez :

Comprendre quand et comment s'affiche la notification d'accueil de l'assistant de configuration.
Savoir comment démarrer, ignorer ou reprendre l'assistant.
Comprendre la différence entre la Configuration de démonstration et la Configuration en direct de AutoScout24.
Savoir quelles options l'assistant écrit et quelles options il n'écrase jamais silencieusement.
Comprendre le modèle de sécurité (protection par rôles/capacités et nonces, gestion du Client Secret).
Documenter l'assistant pour un transfert interne ou une procédure d'intégration client.

Aperçu

L'assistant est enregistré en tant que page d'administration masquée à l'adresse :

wp-admin/admin.php?page=as24ci-setup-wizard

Il n'est pas répertorié dans le sous-menu Car Market Hub. Les points d'entrée sont :

La notification d'administration Bienvenue dans ADP Car Market Hub qui apparaît après la première activation.
Le lien Lancer l'assistant de configuration situé près du haut de Car Market Hub → Dashboard.
La carte Assistant de configuration en haut de Car Market Hub → Tools.

L'assistant ne redirige jamais automatiquement après l'activation. La notification d'administration est informative et propose deux boutons : Démarrer l'assistant de configuration et Ignorer pour l'instant.

Configuration requise ou prérequis

Un utilisateur WordPress disposant de la capacité de gestion de l'extension (Plugin::CAP_MANAGE).
Un horodatage de première activation enregistré par le hook d'activation de l'extension. Les installations existantes qui effectuent une mise à niveau sans réactivation ne voient pas la notification d'accueil, mais peuvent toujours ouvrir l'assistant manuellement depuis le Tableau de bord ou l'onglet Outils.
Pour la configuration en direct : identifiants API AutoScout24 (Client ID, Client Secret, Seller ID, URL de base de l'API).
Pour la configuration de démonstration : aucun identifiant API n'est requis.

Flux de l'assistant

Étape 1 — Mode

Choisissez entre deux parcours de configuration :

Configuration de démonstration — installe un ensemble sélectionné de véhicules de démonstration, applique des valeurs par défaut adaptées aux démos et pré-coche l'option d'analyse afin que les pages Tableau de bord et Analyse aient des données à afficher. La configuration de démonstration est une opération explicite de réinitialisation et d'injection de données : elle déclenche le parcours Demo_Data::install() existant à la fin.
Configuration en direct de AutoScout24 — enregistre les identifiants réels de AutoScout24 ainsi que les pages et options de fonctionnalités sélectionnées, mais n'installe pas de données de démonstration et ne pré-coche pas l'analyse.

L'étape 1 capture également le pays du concessionnaire (DE, CH, AT, Autre), la devise par défaut (EUR, CHF) et la langue d'administration (valeur par défaut du site plus une petite liste d'autorisation explicite).

Étape 2 — Profil du concessionnaire

Capture l'identité de base du concessionnaire utilisée par d'autres parties de l'extension : nom, rue, code postal, ville, pays, téléphone, e-mail, site web et un ID de média pour le logo. Tous les champs sont facultatifs. Les valeurs soumises sont nettoyées ; les champs laissés vides conservent la valeur stockée existante (aucun champ n'est vidé silencieusement).

Étape 3 — AutoScout24

Capture la connexion API AutoScout24 : Client ID, Client Secret, Seller ID et URL de base de l'API. En mode Démo, cette étape affiche une indication pour "ignorer" ; en mode En direct, les identifiants sont recommandés.

Le champ Client Secret est intentionnellement rendu vide. L'assistant ne réécrit jamais le secret stocké dans le code HTML d'administration. Soumettre le formulaire en laissant ce champ vide (ou uniquement avec des espaces) conserve le secret stocké existant. Soumettre une valeur non vide le remplace. La même règle s'applique sur l'onglet normal des Réglages — voir la Référence des réglages.

L'URL de base est validée par rapport à une liste d'autorisation http/https ; les autres protocoles (par exemple javascript:) sont rejetés.

Étape 4 — Pages

Pour chaque page publique, l'assistant propose trois modes :

Créer automatiquement — wp_insert_post() est appelé avec post_type=page, post_status=publish, le titre canonique et le shortcode canonique comme contenu de la page. Une recherche de titre est effectuée au préalable pour éviter de créer un doublon lorsqu'une page portant le même titre existe déjà.
Utiliser une page existante — l'administrateur saisit l'ID de publication d'une page existante et l'option correspondante (as24ci_page_archive_id, as24ci_page_compare_id, as24ci_page_favorites_id) est mise à jour.
Ignorer — la page n'est pas créée et la valeur de l'option existante est conservée.

Pages canoniques et shortcodes :

Page	Shortcode	Option
Véhicules	`[as24ci_archive]`	`as24ci_page_archive_id`
Comparer les véhicules	`[as24ci_compare]`	`as24ci_page_compare_id`
Favoris	`[as24ci_favorites]`	`as24ci_page_favorites_id`

Si l'option pointe déjà vers une page existante (get_post() renvoie une page publiée), l'assistant la conserve et ne crée pas de doublon. L'assistant ne supprime jamais de pages existantes.

Les alertes de recherche n'ont volontairement pas de page publique dans l'assistant. Les abonnements aux alertes de recherche sont gérés via la barre latérale de filtrage [as24ci_archive] et depuis l'onglet d'administration de la Référence des alertes de recherche.

Étape 5 — Fonctionnalités

Active ou désactive les valeurs par défaut des fonctionnalités les plus courantes. Chaque option est enregistrée avec un marqueur de présence explicite, de sorte que le fait de relancer l'assistant en cours de route n'efface jamais un réglage qui ne figurait pas sur le formulaire :

Boutons de partage social
Fiche technique PDF
Code QR dans le PDF
Coûts d'utilisation pour 100 km
Comparateur
Favoris
Alertes de recherche
Suivi analytique

En mode Démo, l'option d'analyse est pré-cochée. En mode En direct, elle est décochée à moins que l'administrateur ne l'active explicitement.

Les valeurs par défaut masquées sur lesquelles l'assistant s'appuie (emplacement du partage social, ensemble complet de réseaux, mise en page de l'archive = les deux, extrait de liste = 150) ne sont injectées que lorsque l'option correspondante est manquante ; les valeurs existantes sont conservées.

Étape 6 — Terminer

Un résumé en lecture seule des choix effectués. En mode Démo, le bouton de fin est intitulé Installer les données de démonstration et terminer et déclenche le parcours Demo_Data::install() existant. En mode En direct, le bouton de fin enregistre uniquement les réglages collectés par l'assistant.

Après une finalisation réussie :

as24ci_setup_wizard_completed est défini.
as24ci_setup_completed_at est défini sur un horodatage UTC ISO-8601.
as24ci_setup_completed_by est défini sur l'ID utilisateur WordPress.
L'administrateur est redirigé vers le Tableau de bord avec une notification de succès temporaire.

Comportement de la notification d'administration

La notification d'accueil s'affiche uniquement lorsque toutes les conditions suivantes sont remplies :

L'utilisateur actuel dispose de la capacité de gestion de l'extension.
as24ci_setup_first_activation_at existe (enregistré par Plugin::activate() uniquement lorsqu'il est manquant, de sorte que les installations existantes qui effectuent une mise à niveau sans réactivation ne soient pas sollicitées).
as24ci_setup_wizard_completed n'est pas défini.
as24ci_setup_wizard_skipped n'est pas défini.
L'écran actuel n'est pas la page de l'assistant elle-même.

Deux boutons sont proposés :

Démarrer l'assistant de configuration ouvre l'assistant.
Ignorer pour l'instant envoie une requête à admin-post.php?action=as24ci_setup_wizard_skip (avec vérifications de capacité et de nonce). Cela définit as24ci_setup_wizard_skipped=1 et redirige vers le Tableau de bord. La notification ne réapparaît pas lors des chargements ultérieurs des pages d'administration.

L'assistant ne force jamais de redirection après l'activation.

Référence de configuration

Options d'état

Option	Objectif
`as24ci_setup_first_activation_at`	Horodatage de la première activation. Enregistré une fois via `add_option()` ; jamais écrasé lors des (ré)activations ultérieures.
`as24ci_setup_wizard_completed`	Défini sur `1` après une finalisation réussie.
`as24ci_setup_wizard_skipped`	Défini sur `1` lorsque l'administrateur clique sur Ignorer dans la notification d'accueil.
`as24ci_setup_mode`	Soit `demo`, soit `live`.
`as24ci_setup_completed_at`	Horodatage UTC ISO-8601 de l'événement de finalisation.
`as24ci_setup_completed_by`	ID de l'utilisateur WordPress qui a terminé l'assistant.

Options du profil du concessionnaire

as24ci_dealer_name, as24ci_dealer_street, as24ci_dealer_postal_code, as24ci_dealer_city, as24ci_dealer_country, as24ci_dealer_phone, as24ci_dealer_email, as24ci_dealer_website, as24ci_dealer_logo_id, as24ci_dealer_language.

Options existantes que l'assistant peut écrire

CLIENT_ID, CLIENT_SECRET, SELLER_IDS, BASE_URL, DEFAULT_CURRENCY, FEATURE_SOCIAL_SHARE, SOCIAL_SHARE_PLACEMENT, SOCIAL_SHARE_NETWORKS, FEATURE_PDF_DATASHEET, FEATURE_COMPARE, FEATURE_FAVORITES, FEATURE_SEARCH_AGENT, ANALYTICS_ENABLED, ENVKV_SHOW_COSTS_100KM, PDF_MANAGER_SETTINGS (clé show_qr), DESIGN_ARCHIVE_LAYOUT, ARCHIVE_LIST_EXCERPT_LENGTH, as24ci_page_archive_id, as24ci_page_compare_id, as24ci_page_favorites_id.

L'assistant met à jour uniquement les options dont les champs de formulaire sont réellement présents dans les données POST soumises. Les champs non soumis conservent leur valeur existante.

Sécurité

Contrôle des capacités. Chaque point d'entrée (la page de l'assistant, le gestionnaire d'enregistrement du formulaire et le gestionnaire d'annulation) appelle current_user_can( Plugin::CAP_MANAGE ) et s'interrompt avec wp_die() si la capacité est manquante.
Nonces. L'enregistrement du formulaire utilise wp_nonce_field() / check_admin_referer() ; l'URL d'annulation utilise wp_nonce_url() / check_admin_referer().
Client Secret. Le secret stocké n'est jamais réaffiché dans le code HTML d'administration. Les soumissions vides ou contenant uniquement des espaces préservent la valeur stockée.
Validation des URL. L'URL de base et le site web du concessionnaire doivent utiliser le protocole http ou https ; les autres protocoles sont rejetés.
Validation des e-mails. L'e-mail du concessionnaire est validé avec is_email(). Une saisie non valide préserve silencieusement la valeur existante ; une soumission vide l'efface.
Nettoyage des données (Sanitization). Le mode, le pays, la devise, la langue et le mode de page sont vérifiés par rapport à des listes d'autorisation explicites. Les champs de texte utilisent sanitize_text_field(). Les ID de page utilisent absint().
Échappement de sortie. Chaque valeur dynamique affichée par l'assistant utilise esc_html, esc_attr ou esc_url.

Notes opérationnelles

L'assistant ne modifie jamais les réglages lors de l'activation de l'extension. L'activation injecte uniquement des valeurs par défaut non destructives via add_option().
L'assistant ne modifie jamais les réglages lorsqu'une étape est chargée — les réglages sont mis à jour uniquement lorsque l'administrateur soumet une étape.
La configuration de démonstration reste une réinitialisation et une injection explicites : elle réinitialise délibérément les options contrôlées par la démo et insère des véhicules de démonstration. Utilisez-la uniquement sur des sites de démonstration ou d'évaluation dédiés.
La configuration en direct est non destructive vis-à-vis des véhicules et des réglages du client. Elle enregistre les réglages et les pages sélectionnés dans l'assistant mais n'installe pas de données de démonstration.
L'analyse est pré-cochée uniquement en mode Démo. En mode En direct, l'option nécessite un consentement explicite (opt-in). Voir la Rétention de l'analyse pour les considérations relatives à la confidentialité.
L'assistant ne gère pas le provisionnement de l'IA, les importations automatiques, la planification ou la synchronisation complète. Ceux-ci sont configurés ultérieurement dans les onglets d'administration correspondants.
L'assistant ne remplace pas un outil de consentement aux cookies, une CMP, une politique de confidentialité ou un examen juridique. N'activez l'analyse sur un site en production qu'après avoir vérifié ces exigences.

Dépannage

La notification d'accueil n'apparaît pas. L'assistant a été soit complété (as24ci_setup_wizard_completed), soit ignoré (as24ci_setup_wizard_skipped), l'utilisateur actuel ne dispose pas des droits de gestion, ou l'horodatage de première activation n'a pas été enregistré (typique pour les mises à niveau qui n'ont pas déclenché une nouvelle activation). Ouvrez plutôt l'assistant depuis Car Market Hub → Tools → Setup Wizard.
J'ai ignoré l'assistant. Comment puis-je le réouvrir ? Utilisez le lien Lancer l'assistant de configuration sur Car Market Hub → Dashboard ou la carte Assistant de configuration sur Car Market Hub → Tools.
L'assistant n'a pas créé mes pages. Une page avec le même titre existait déjà et a été réutilisée, ou l'option Ignorer a été sélectionnée pour cette page à l'étape 4. Ouvrez Pages dans WordPress et confirmez. L'assistant ne supprime jamais de pages.
Le champ Client Secret est vide lorsque je réouvre l'étape 3. C'est un comportement normal. Le secret enregistré n'est jamais réaffiché. Laisser le champ vide conserve la valeur enregistrée.
L'analyse (Analytics) n'est pas activée après la configuration Live. En mode Live, l'activation de l'analyse est optionnelle (opt-in). Réouvrez l'assistant et activez-la à l'étape 5, ou activez-la dans l'onglet Analytics. Confirmez d'abord le consentement aux cookies et les exigences de confidentialité.
Les données de démonstration n'ont pas été installées. Assurez-vous d'avoir sélectionné Configuration Démo à l'étape 1 et d'avoir cliqué sur Installer les données de démonstration et terminer à l'étape 6. La configuration Live n'installe pas de données de démonstration.
Le comparateur ou les favoris sont vides dans la démo. Le comparateur et les favoris sont basés sur le localStorage ; la démo remplit une solution de secours qui initialise le localStorage lors du premier chargement de la page. Ouvrez la page Comparateur ou Favoris une fois dans la même session de navigation pour déclencher l'initialisation.
L'assistant n'écrase pas mes réglages existants. C'est exact. L'assistant écrit uniquement les options dont les champs de formulaire sont soumis. Le réexécuter partiellement n'efface jamais les réglages non liés.