Documentation · Annexes

Référence des réglages

Cette annexe est une liste de référence des clés d'option que l'extension ADP Car Market Hub lit et écrit.

Quand utiliser ce document

Utilisez cette référence lorsque vous devez rechercher la clé d'option derrière un champ d'administration, lorsque vous souhaitez lire une valeur par programmation avec get_option(), ou lorsque vous auditez un déploiement. Pour l'interface utilisateur de configuration, voir Référence des réglages (Admin). Pour le modèle de stockage conceptuel, voir Stockage des clés d'option et des réglages.

Aperçu

Toutes les options de l'extension sont stockées dans wp_options avec le préfixe as24ci_. Les commutateurs booléens sont stockés sous forme de chaînes de caractères '1' (activé) et '0' (désactivé), sauf indication contraire. Les clés canoniques sont définies comme des constantes dans includes/class-as24ci-options.php (AS24CI\Options) ; préférez toujours les constantes de PHP.

L'extension n'enregistre pas les options via l'API Settings de WordPress. Chaque onglet d'administration enregistre ses propres options via des gestionnaires dédiés protégés par des vérifications de capacités et de nonces.

API et authentification

Clé d'option	Objectif
`as24ci_base_url`	URL de base de l'API de données (généralement un point de terminaison AutoScout24 ou un proxy fourni par le client).
`as24ci_token_url`	Point de terminaison du jeton OAuth.
`as24ci_token_audience`	Valeur d'audience JWT. Dérivée automatiquement de l'URL de base configurée lorsqu'elle n'est pas définie explicitement.
`as24ci_client_id`	ID client OAuth.
`as24ci_client_secret`	Secret client OAuth. Sensible. Stocké non chiffré ; à traiter comme un identifiant.
`as24ci_seller_ids`	Un ou plusieurs ID de vendeur (tableau ou chaîne séparée par des virgules en entrée).
`as24ci_default_currency`	Code de devise ISO 4217 par défaut utilisé lorsqu'aucune devise par véhicule n'est fournie.

Comportement d'importation

Clé d'option	Objectif
`as24ci_default_post_status`	État initial de la publication pour les véhicules nouvellement importés.
`as24ci_default_post_author`	ID d'utilisateur utilisé comme auteur pour les véhicules nouvellement importés.
`as24ci_import_images`	Activer l'importation d'images.
`as24ci_max_images`	Nombre maximum d'images par véhicule (`0` = illimité).
`as24ci_convert_to_webp`	Convertir les images importées en WebP (nécessite GD ou Imagick).
`as24ci_webp_quality`	Qualité WebP (1–100, par défaut `80`).
`as24ci_full_sync`	Supprimer les véhicules locaux absents du flux distant à la fin de chaque exécution. Optionnel (opt-in).
`as24ci_verbose_logging`	Enregistrer des détails supplémentaires par champ et par image pendant les importations.

Planificateur et automatisation

Clé d'option	Objectif
`as24ci_auto_import_enabled`	Commutateur principal pour l'événement d'importation WP-Cron.
`as24ci_cron_schedule`	Clé de planification : `hourly`, `as24ci_every_6_hours`, `twicedaily`, `daily`, `as24ci_custom`.
`as24ci_cron_start_time`	Heure de début au format `HH:MM` (24h, fuseau horaire du site WordPress) pour `daily` et `twicedaily`.
`as24ci_cron_custom_minutes`	Intervalle en minutes pour `as24ci_custom`. Limité à un minimum de `15`.
`as24ci_cron_mode`	`wp-cron` ou `server-cron`. Oriente les indications de l'interface d'administration.
`as24ci_cron_token`	Jeton pour le point de terminaison REST `cron-import`. Sensible. Une valeur vide désactive le point de terminaison.
`as24ci_cron_max_vehicles`	Nombre maximum de véhicules traités par exécution cron / REST (`0` = illimité).
`as24ci_cron_image_queue`	Utiliser la file d'attente d'images pendant les exécutions cron / REST.
`as24ci_last_run_time`	Horodatage Unix de la dernière exécution terminée.
`as24ci_last_run_status`	Tableau des compteurs de la dernière exécution.
`as24ci_last_run_manual`	`1` si la dernière exécution a été déclenchée manuellement.
`as24ci_last_external_cron_run`	Horodatage Unix du dernier ping `?as24ci_cron=1`.

API REST

Clé d'option	Objectif
`as24ci_rest_api_enabled`	Lorsque `'1'`, enregistre les routes publiques `/vehicles` et `/vehicles/{id}`. Par défaut `'0'`.

Pages par défaut et désinstallation

Clé d'option	Objectif
`as24ci_create_default_pages`	Lorsque cette case est cochée au moment de l'enregistrement, l'extension crée les pages Véhicules, Comparer et Favoris si elles sont manquantes. Les pages existantes ne sont pas écrasées.
`as24ci_page_archive_id`	ID de la page Véhicules créée lors de l'activation.
`as24ci_page_compare_id`	ID de la page Comparer créée lors de l'activation.
`as24ci_page_favorites_id`	ID de la page Favoris créée lors de l'activation.
`as24ci_delete_data_on_uninstall`	Lorsque `'1'`, la désinstallation supprime les véhicules, les leads, les pièces jointes importées et les pages créées lors de l'activation.

Traitement des leads et formulaire de contact

Clé d'option	Objectif
`as24ci_lead_recipient_email`	Surcharger l'e-mail du destinataire pour les notifications de leads.
`as24ci_lead_field_name`, `as24ci_lead_field_email`, `as24ci_lead_field_phone`, `as24ci_lead_field_message`	Commutateurs de visibilité par champ pour le formulaire de contact.
`as24ci_lead_consent_enabled`, `as24ci_lead_consent_text`, `as24ci_lead_privacy_url`	Configuration de la case à cocher de consentement.
`as24ci_lead_msg_success`, `as24ci_lead_msg_error`	Messages d'état sur le frontend.
`as24ci_lead_email_subject_dealer`, `as24ci_lead_email_subject_customer`, `as24ci_lead_email_template_dealer`, `as24ci_lead_email_template_customer`	Modèles d'e-mails de notification.

Webhooks

Clé d'option	Objectif
`as24ci_webhook_url_new_lead`	URL cible pour l'événement `new_lead`. Une valeur vide désactive l'événement.
`as24ci_webhook_url_new_import`	URL cible pour l'événement `new_import`. Une valeur vide désactive l'événement.
`as24ci_webhook_secret`	Secret de signature HMAC-SHA256. Sensible. Une valeur vide désactive la signature.

Assistant IA (optionnel)

Les fonctionnalités d'IA utilisent la configuration managée Google Gemini dans ADP Car Market Hub. Il n'existe aucune option de fournisseur, de modèle ou de clé API dans wp_options. La clé et le modèle Gemini managés sont des constantes PHP sur AS24CI\Ai_Config (MANAGED_GEMINI_API_KEY, MANAGED_GEMINI_MODEL) fournies par AD Promotion après l'installation.

Clé d'option	Objectif
`as24ci_ai_assistant_enabled`	Commutateur principal.
`as24ci_ai_assistant_language`, `as24ci_ai_assistant_tone`, `as24ci_ai_assistant_max_length`	Paramètres de génération.
`as24ci_ai_assistant_auto_generate`	Générer automatiquement des descriptions lors de l'importation.
`as24ci_ai_assistant_custom_prompt`	Modèle de prompt personnalisé optionnel.
`as24ci_ai_gen_alt_text`, `as24ci_ai_gen_seo`, `as24ci_ai_extract_highlights`	Commutateurs de génération automatique auxiliaires.

Réservation d'essai routier (optionnel)

Clé d'option	Objectif
`as24ci_test_drive_enabled`	Commutateur principal.
`as24ci_test_drive_available_days`	Numéros de jours de la semaine séparés par des virgules (`0` = dimanche).
`as24ci_test_drive_start_time`, `as24ci_test_drive_end_time`	Plage horaire quotidienne au format `HH:MM`.
`as24ci_test_drive_slot_duration`	Durée du créneau en minutes.
`as24ci_test_drive_blackout_dates`	Liste sérialisée des dates d'exclusion (jours fériés/indisponibles).

Alertes de recherche et commutateurs de fonctionnalités

Clé d'option	Objectif
`as24ci_feature_search_agent`	Activer les alertes de recherche (Smart Stock Alerts).
`as24ci_feature_compare`	Boutons de comparaison et page de comparaison.
`as24ci_feature_favorites`	Favoris / liste d'envies.
`as24ci_feature_schema`	Métadonnées Schema.org et Open Graph sur les pages uniques.
`as24ci_feature_social_share`	Boutons de partage social.
`as24ci_social_share_placement`	Emplacement des boutons de partage social sur la page unique.
`as24ci_social_share_networks`	Réseaux sociaux actifs pour les boutons de partage.
`as24ci_feature_sitemap`	Intégration du sitemap.
`as24ci_feature_dashboard_widget`	Widget du tableau de bord d'administration.
`as24ci_feature_lazy_loading`	Chargement différé des images (lazy loading).
`as24ci_feature_bulk_actions`	Actions groupées sur la liste des véhicules.
`as24ci_feature_export`	Export CSV/JSON depuis les Outils.
`as24ci_feature_pdf_datasheet`	Téléchargement de la fiche technique PDF (commutateur principal pour le bouton frontend "Télécharger le PDF").
`as24ci_pdf_manager_settings`	Tableau des réglages d'identité visuelle, de mise en page, de QR code et de contenu pour le rendu de la fiche technique PDF. Indépendant de `as24ci_feature_pdf_datasheet`.

Analyse

Clé d'option	Objectif
`as24ci_analytics_enabled`	Commutateur principal pour le suivi analytique.
`as24ci_analytics_bi_enabled`	Événements étendus de Business Intelligence (recherches par filtre, ouvertures de contact, soumissions de leads).
`as24ci_analytics_require_consent`	Bloquer le suivi jusqu'à ce que le consentement du visiteur soit accordé.
`as24ci_analytics_filter_minimization`	Nettoyer la saisie de recherche en texte libre avant de stocker les événements.
`as24ci_analytics_retention_days`	Période de rétention pour la table d'analyse (par défaut `180`).
`as24ci_analytics_privacy_jurisdiction`	Label de loi sur la confidentialité (`auto`, `gdpr`, `dsgvo`, `revdsg`, `uk_gdpr`, `generic`).

Comparaison et financement

Clé d'option	Objectif
`as24ci_compare_max_vehicles`	Nombre maximum de véhicules comparés simultanément. Limité entre 2 et 8.
`as24ci_financing_enabled`	Activer le calculateur de financement.
`as24ci_financing_default_rate`	Taux d'intérêt annuel par défaut (%). Plage autorisée : 0–50.
`as24ci_financing_default_months`	Durée par défaut du prêt en mois (`12`, `24`, `36`, `48`, `60`, `72`, `84`).
`as24ci_financing_down_payment`	Apport initial par défaut (%). Plage autorisée : 0–100.
`as24ci_financing_placement`	`below_gallery`, `sidebar` ou `end_of_page`.

Design et mise en page

L'extension expose un grand nombre d'options de design sous les préfixes as24ci_design_*, as24ci_single_*, as24ci_archive_*, as24ci_fav_*, as24ci_comp_* et as24ci_badge_*. Elles contrôlent les couleurs, la typographie, les espacements, l'apparence des badges et le CSS personnalisé. Reportez-vous aux constantes dans AS24CI\Options pour la liste exhaustive.

La mise en page au niveau de la page utilise des clés dédiées :

Clé d'option	Objectif
`as24ci_layout_manager_enabled`	Commutateur principal pour le Layout Manager.
`as24ci_lm_zone_`, `as24ci_lm_block_`	Configuration par zone et par bloc.
`as24ci_layout_archive_columns`	Nombre de colonnes sur la grille d'archive (1–4, par défaut 3).
`as24ci_archive_default_sort`	Ordre de tri par défaut de l'archive (`date_desc`, `price_asc`, `price_desc`, `mileage_asc`).
`as24ci_archive_per_page`	Véhicules affichés par page sur l'archive (par défaut 24).
`as24ci_archive_list_excerpt_length`	Nombre maximum de caractères de l'extrait en vue Liste (0–500, par défaut 75 ; `0` masque l'extrait).
`as24ci_layout_search_filters`	Blocs de filtres actifs dans la zone des filtres de recherche.
`as24ci_layout_single_main`, `as24ci_layout_single_sidebar`, `as24ci_layout_single_bottom`	Composition de la page de véhicule unique.

Filtres et visibilité des champs

Clé d'option	Objectif
`as24ci_filters_enabled`	Tableau des clés de filtres activées pour l'archive publique (`null` signifie que tout est activé).
`as24ci_field_visibility`	Carte de visibilité par vue pour `car_details`, `sidebar`, `compare` et `favorites`.
`as24ci_mapping_overrides`	Surcharges de libellés et de visibilité par champ pour les champs AS24 importés (cartes sérialisées `labels` / `visible`).

API Hub et emplacements

Clé d'option	Objectif
`as24ci_hub_api_key`	Clé API pour l'intégration Hub / Market Insights. Sensible.
`as24ci_hub_target_market`	Code du marché cible utilisé par l'intégration Hub.
`as24ci_locations`	Liste sérialisée des emplacements de concessions (nom, adresse, ID de vendeur, horaires). Autoload désactivé.

CMH Team

Clé d'option	Objectif
`as24ci_team_members`	Liste sérialisée des membres de l'équipe de la concession gérés par l'extension (contacts commerciaux). Autoload désactivé.
`as24ci_team_location_defaults`	Correspondance de l'ID de vendeur AutoScout24 → ID du membre de l'équipe par défaut (contact par défaut au niveau de l'emplacement). Autoload désactivé.
`as24ci_team_standards`	Réglages de contact globaux de secours / généraux de la concession (ID du membre par défaut global et données de contact générales). Autoload désactivé.
`as24ci_team_rules`	Drapeaux de comportement d'attribution automatique pour CMH Team. Autoload désactivé.

Surveillance de la qualité des données

Clé d'option	Objectif
`as24ci_dq_scan_enabled`	Commutateur principal.
`as24ci_dq_scan_frequency`	`daily` ou `twicedaily`.
`as24ci_dq_scan_time`	Heure de la première exécution au format `HH:00` (fuseau horaire du site WordPress).
`as24ci_last_term_hash`, `as24ci_taxonomy_anomalies`	État de l'analyse interne.
`as24ci_dealer_name`	Nom de la concession.
`as24ci_dealer_street`	Adresse (rue).
`as24ci_dealer_postal_code`	Code postal.
`as24ci_dealer_city`	Ville.
`as24ci_dealer_country`	Pays.
`as24ci_dealer_phone`	Numéro de téléphone.
`as24ci_dealer_email`	E-mail de contact.
`as24ci_dealer_website`	URL du site web.
`as24ci_dealer_logo_id`	ID de pièce jointe du logo de la concession.
`as24ci_dealer_language`	Langue préférée du frontend (`site_default` ou une locale telle que `de_DE`).

Assistant de configuration

Clé d'option	Objectif
`as24ci_setup_wizard_completed`	`1` une fois que l'assistant de configuration a été complété.
`as24ci_setup_wizard_skipped`	`1` si l'assistant de configuration a été ignoré.
`as24ci_setup_mode`	Mode de configuration sélectionné.
`as24ci_setup_completed_at`	Horodatage de la fin de la configuration.
`as24ci_setup_completed_by`	ID de l'utilisateur ayant complété la configuration.
`as24ci_setup_first_activation_at`	Horodatage de la première activation de l'extension.

EnVKV (Étiquetage énergétique allemand)

Clé d'option	Objectif
`as24ci_envkv_year`	Année de référence pour le calcul des coûts EnVKV.
`as24ci_envkv_price_petrol`, `as24ci_envkv_price_diesel`, `as24ci_envkv_price_electric`	Prix de l'énergie par type de carburant.
`as24ci_envkv_co2_price_low`, `as24ci_envkv_co2_price_med`, `as24ci_envkv_co2_price_high`	Tranches de prix du CO₂.
`as24ci_envkv_show_costs_100km`	Afficher les coûts estimés par 100 km.

Content Studio (optionnel)

Content Studio est un module délimité avec ses propres clés d'option (constantes dans includes/class-as24ci-content-studio-options.php, AS24CI\Content_Studio_Options).

Clé d'option	Objectif
`as24ci_content_studio_db_version`	Version du schéma pour les tables personnalisées de Content Studio.
`as24ci_content_studio_google_api_key`	Clé API Google appartenant au client, utilisée par le client texte de Content Studio. Sensible.
`as24ci_content_studio_default_language`	Langue de sortie par défaut pour les Copy Packages générés.
`as24ci_content_studio_default_tone`	Ton par défaut pour les Copy Packages générés.
`as24ci_content_studio_brand_voice`	Indication de style de voix de marque du concessionnaire optionnelle (max 800 caractères).
`as24ci_content_studio_disclaimer_text`	Texte de clause de non-responsabilité obligatoire optionnel pour les textes générés (max 500 caractères).
`as24ci_content_studio_compliance_notes`	Notes de conformité optionnelles pour les textes générés (max 1000 caractères).

Activation de la licence

L'extension active et re-valide sa licence auprès de la plateforme API ADP Car Market Hub. Seuls la clé de licence et le secret du signal de rafraîchissement sont des secrets (stockés chiffrés au repos via AS24CI\Secrets) ; toutes les autres clés contiennent un état de licence non secret utilisé pour restreindre les fonctionnalités d'écriture opérationnelles.

Clé d'option	Objectif
`as24ci_license_key`	Clé de licence de la plateforme API chiffrée (enveloppe de secrets). Sensible.
`as24ci_license_status`	Statut opérationnel de la licence (`License_Manager::STATUS_*`).
`as24ci_license_last_checked_at`	Horodatage Unix de la dernière réponse réussie de la plateforme API (`0` = jamais).
`as24ci_license_last_error`	Dernier code d'erreur de licence sous forme de code stable uniquement.
`as24ci_license_prefix`	Préfixe de clé de licence sécurisé et non secret renvoyé par la plateforme API.
`as24ci_license_plan`	Libellé de l'offre de licence.
`as24ci_license_support_until`	Horodatage ISO jusqu'auquel le support est inclus (informatif).
`as24ci_license_expires_at`	Horodatage ISO auquel la licence expire (informatif).
`as24ci_license_installation_uid`	UID d'installation émis par la plateforme API lors de l'activation.
`as24ci_license_manifest`	Objet manifeste non secret renvoyé par la plateforme API.
`as24ci_license_feature_rights`	Carte des droits de fonctionnalités renvoyée par la plateforme API.
`as24ci_license_import_policy`	Objet de politique d'importation renvoyé par la plateforme API.
`as24ci_license_normalized_domain`	Domaine normalisé pour lequel la licence a été activée/validée pour la dernière fois.
`as24ci_license_last_reported_version`	Version de l'extension la plus récemment confirmée comme signalée à la plateforme API.
`as24ci_license_refresh_signal_secret`	Secret partagé chiffré par installation utilisé pour authentifier les signaux entrants de rafraîchissement de licence. Sensible.

Identifiant IA managé (synchronisation de la plateforme API)

L'identifiant Google Gemini du client est fourni de serveur à serveur par la plateforme API et géré par AS24CI\Ai_Credential_Manager. La clé Gemini est stockée uniquement dans une enveloppe chiffrée ; toutes les autres lignes contiennent des métadonnées sécurisées pour la carte de statut d'administration.

Clé d'option	Objectif
`as24ci_ai_credential_envelope`	Enveloppe d'identifiant Gemini chiffrée. Jamais chargée automatiquement, jamais affichée. Sensible.
`as24ci_ai_credential_provider`	Valeur brute du fournisseur renvoyée par la plateforme API (par ex. `google` / `gemini`).
`as24ci_ai_credential_display_provider`	Libellé du fournisseur visible par le client (toujours "Google Gemini").
`as24ci_ai_credential_api_model`	Modèle exactement tel que signalé par la plateforme API.
`as24ci_ai_credential_effective_model`	Modèle Gemini d'exécution effectif après validation/repli.
`as24ci_ai_credential_fingerprint`	Empreinte non secrète de l'identifiant fourni (marqueur de rotation).
`as24ci_ai_credential_synced_at`	Horodatage Unix de la dernière synchronisation réussie de l'identifiant.
`as24ci_ai_credential_checked_at`	Horodatage Unix de la dernière tentative de synchronisation.
`as24ci_ai_credential_status`	Chaîne de statut de disponibilité de l'IA locale.
`as24ci_ai_credential_last_error`	Dernier code de raison de décision/erreur de synchronisation non sensible.
`as24ci_ai_usage_reporting_required`	Indique si la plateforme API requiert le signalement de l'utilisation de l'IA.

Mises à jour et visibilité des mises à jour

Suivi sécurisé et non secret pour le flux de mise à jour privée. Aucune de ces lignes n'est chargée automatiquement, et aucune ne stocke d'URL de package signé, de signature, de secret ou de clé de licence.

Clé d'option	Objectif
`as24ci_update_last_check_diag`	Dernier diagnostic de vérification de mise à jour privée (métadonnées non secrètes uniquement).
`as24ci_update_visibility_last_refresh_at`	Horodatage Unix de la dernière tentative de rafraîchissement de la visibilité.
`as24ci_update_visibility_last_refresh_reason`	Code de raison stable pour la dernière décision de rafraîchissement.
`as24ci_update_visibility_last_refresh_result`	Résultat de la dernière tentative de rafraîchissement (`refreshed` ou `skipped`).
`as24ci_update_visibility_last_skip_reason`	Code de raison stable pour le dernier rafraîchissement ignoré.
`as24ci_update_visibility_last_inconsistency_refresh_at`	Horodatage du dernier rafraîchissement déclenché pour réparer un état transitoire incohérent.
`as24ci_update_last_transient_snapshot`	Instantané léger et sécurisé du transitoire `update_plugins` pour cette extension.

Suivi du schéma et des migrations

Clé d'option	Objectif
`as24ci_db_version`	Version globale des données de l'extension.
`as24ci_caps_version`	Version de la migration des rôles/capacités.
`as24ci_vehicles_db_version`, `as24ci_search_agent_db_version`, `as24ci_analytics_db_version`	Versions de schéma par table.

Ne modifiez pas ces valeurs manuellement à moins que vous ne souhaitiez forcer une nouvelle migration.

Notes opérationnelles

Valeurs sensibles. Traitez as24ci_client_secret, as24ci_cron_token, as24ci_webhook_secret, as24ci_hub_api_key et as24ci_content_studio_google_api_key comme des identifiants. Ne les validez pas dans votre système de contrôle de version et ne les affichez pas dans des modèles ou des journaux. Les options chiffrées au repos as24ci_license_key, as24ci_license_refresh_signal_secret et as24ci_ai_credential_envelope sont stockées via AS24CI\Secrets. La clé Gemini managée fournie au moment de l'exécution appartient à AD Promotion dans AS24CI\Ai_Config et n'est pas stockée sous forme d'option WordPress en texte clair.
Encodage des booléens. La plupart des commutateurs booléens sont stockés sous forme de chaînes '1' et '0'. Comparez-les avec des chaînes ou transtypez-les via (string) avant de comparer.
Filtrage au moment de l'exécution. Les filtres WordPress standards (option_<key>, pre_option_<key>, default_option_<key>) fonctionnent pour n'importe quelle option ici. C'est la méthode recommandée pour surcharger les valeurs au moment du déploiement sans écrire dans la base de données.
Multisite. Toutes les clés ci-dessus sont spécifiques à chaque site. Configurez-les sur chaque site individuellement à moins d'avoir mis en place une automatisation à l'échelle du réseau.
Valeurs par défaut. Les valeurs par défaut sont appliquées dans le code. Les valeurs par défaut exactes peuvent changer d'une version à l'autre ; vérifiez par rapport au code source actuel avant de publier.