Documentazione · Appendici

Riferimento delle impostazioni

Questa appendice è un elenco di riferimento delle chiavi di opzione che il plugin ADP Car Market Hub legge e scrive.

Quando utilizzare questo documento

Utilizzare questo riferimento quando è necessario cercare la chiave di opzione dietro un campo di amministrazione, quando si desidera leggere un valore a livello di codice con get_option() o quando si esegue l'audit di una distribuzione. Per l'interfaccia utente di configurazione, vedere Settings Reference (Admin). Per il modello di archiviazione concettuale, vedere Option Keys And Settings Storage.

Panoramica

Tutte le opzioni del plugin sono memorizzate in wp_options con il prefisso as24ci_. I selettori booleani sono memorizzati come stringhe '1' (abilitato) e '0' (disabilitato) se non diversamente specificato. Le chiavi canoniche sono definite come costanti in includes/class-as24ci-options.php (AS24CI\Options); preferire sempre le costanti da PHP.

Il plugin non registra le opzioni tramite la Settings API di WordPress. Ogni scheda di amministrazione salva le proprie opzioni tramite gestori dedicati protetti da controlli di funzionalità e nonce.

API e autenticazione

Chiave opzione	Scopo
`as24ci_base_url`	URL di base dell'API dei dati (in genere un endpoint AutoScout24 o un proxy fornito dal cliente).
`as24ci_token_url`	Endpoint del token OAuth.
`as24ci_token_audience`	Valore audience JWT. Derivato automaticamente dall'URL di base configurato quando non impostato esplicitamente.
`as24ci_client_id`	Client ID OAuth.
`as24ci_client_secret`	Client secret OAuth. Sensibile. Memorizzato non crittografato; trattare come credenziale.
`as24ci_seller_ids`	Uno o più Seller ID (array o stringa separata da virgole nell'input).
`as24ci_default_currency`	Codice valuta ISO 4217 predefinito utilizzato quando non viene fornita alcuna valuta per veicolo.

Comportamento di importazione

Chiave opzione	Scopo
`as24ci_default_post_status`	Stato iniziale dell'articolo per i veicoli appena importati.
`as24ci_default_post_author`	ID utente utilizzato come autore per i veicoli appena importati.
`as24ci_import_images`	Abilita l'importazione delle immagini.
`as24ci_max_images`	Numero massimo di immagini per veicolo (`0` = illimitato).
`as24ci_convert_to_webp`	Converti le immagini importate in WebP (richiede GD o Imagick).
`as24ci_webp_quality`	Qualità WebP (1–100, predefinita `80`).
`as24ci_full_sync`	Elimina i veicoli locali mancanti dal feed remoto al termine di ogni esecuzione. Opzione facoltativa (opt-in).
`as24ci_verbose_logging`	Registra dettagli aggiuntivi per campo e per immagine durante le importazioni.

Pianificazione e automazione

Chiave opzione	Scopo
`as24ci_auto_import_enabled`	Interruttore principale per l'evento di importazione WP-Cron.
`as24ci_cron_schedule`	Chiave di pianificazione: `hourly`, `as24ci_every_6_hours`, `twicedaily`, `daily`, `as24ci_custom`.
`as24ci_cron_start_time`	Ora di inizio in `HH:MM` (24 ore, fuso orario del sito WordPress) per `daily` e `twicedaily`.
`as24ci_cron_custom_minutes`	Intervallo in minuti per `as24ci_custom`. Limitato a un minimo di `15`.
`as24ci_cron_mode`	`wp-cron` o `server-cron`. Guida i suggerimenti dell'interfaccia utente di amministrazione.
`as24ci_cron_token`	Token per l'endpoint REST `cron-import`. Sensibile. Un valore vuoto disabilita l'endpoint.
`as24ci_cron_max_vehicles`	Numero massimo di veicoli elaborati per esecuzione cron / REST (`0` = illimitato).
`as24ci_cron_image_queue`	Utilizza la coda delle immagini durante le esecuzioni cron / REST.
`as24ci_last_run_time`	Timestamp Unix dell'ultima esecuzione completata.
`as24ci_last_run_status`	Array dei conteggi dell'ultima esecuzione.
`as24ci_last_run_manual`	`1` se l'ultima esecuzione è stata avviata manualmente.
`as24ci_last_external_cron_run`	Timestamp Unix dell'ultimo ping di `?as24ci_cron=1`.

REST API

Chiave opzione	Scopo
`as24ci_rest_api_enabled`	Quando `'1'`, registra le rotte pubbliche `/vehicles` e `/vehicles/{id}`. Predefinito `'0'`.

Pagine predefinite e disinstallazione

Chiave opzione	Scopo
`as24ci_create_default_pages`	Se selezionata al momento del salvataggio, il plugin crea le pagine Cars, Compare e Favorites se mancanti. Le pagine esistenti non vengono sovrascritte.
`as24ci_page_archive_id`	ID pagina della pagina Cars creata all'attivazione.
`as24ci_page_compare_id`	ID pagina della pagina Compare creata all'attivazione.
`as24ci_page_favorites_id`	ID pagina della pagina Favorites creata all'attivazione.
`as24ci_delete_data_on_uninstall`	Quando `'1'`, la disinstallazione rimuove veicoli, lead, allegati importati e le pagine create all'attivazione.

Gestione dei lead e modulo di contatto

Chiave opzione	Scopo
`as24ci_lead_recipient_email`	Sovrascrivi l'email del destinatario per le notifiche dei lead.
`as24ci_lead_field_name`, `as24ci_lead_field_email`, `as24ci_lead_field_phone`, `as24ci_lead_field_message`	Interruttori di visibilità per campo per il modulo di contatto.
`as24ci_lead_consent_enabled`, `as24ci_lead_consent_text`, `as24ci_lead_privacy_url`	Configurazione della casella di controllo del consenso.
`as24ci_lead_msg_success`, `as24ci_lead_msg_error`	Messaggi di stato del frontend.
`as24ci_lead_email_subject_dealer`, `as24ci_lead_email_subject_customer`, `as24ci_lead_email_template_dealer`, `as24ci_lead_email_template_customer`	Modelli di email di notifica.

Webhook

Chiave opzione	Scopo
`as24ci_webhook_url_new_lead`	URL di destinazione per l'evento `new_lead`. Se vuoto, disabilita l'evento.
`as24ci_webhook_url_new_import`	URL di destinazione per l'evento `new_import`. Se vuoto, disabilita l'evento.
`as24ci_webhook_secret`	Segreto di firma HMAC-SHA256. Sensibile. Se vuoto, disabilita la firma.

AI Assistant (opzionale)

Le funzionalità di intelligenza artificiale utilizzano la configurazione gestita di Google Gemini in ADP Car Market Hub. Non esiste alcuna opzione per provider, modello o chiave API in wp_options. La chiave e il modello Gemini gestiti sono costanti PHP su AS24CI\Ai_Config (MANAGED_GEMINI_API_KEY, MANAGED_GEMINI_MODEL) fornite da AD Promotion dopo l'installazione.

Chiave opzione	Scopo
`as24ci_ai_assistant_enabled`	Interruttore principale.
`as24ci_ai_assistant_language`, `as24ci_ai_assistant_tone`, `as24ci_ai_assistant_max_length`	Parametri di generazione.
`as24ci_ai_assistant_auto_generate`	Genera automaticamente le descrizioni all'importazione.
`as24ci_ai_assistant_custom_prompt`	Modello di prompt personalizzato opzionale.
`as24ci_ai_gen_alt_text`, `as24ci_ai_gen_seo`, `as24ci_ai_extract_highlights`	Interruttori ausiliari di autogenerazione.

Prenotazione Test Drive (opzionale)

Chiave opzione	Scopo
`as24ci_test_drive_enabled`	Interruttore principale.
`as24ci_test_drive_available_days`	Numeri dei giorni della settimana separati da virgole (`0` = domenica).
`as24ci_test_drive_start_time`, `as24ci_test_drive_end_time`	Finestra temporale giornaliera in `HH:MM`.
`as24ci_test_drive_slot_duration`	Durata dello slot in minuti.
`as24ci_test_drive_blackout_dates`	Elenco serializzato di date di esclusione (blackout).

Avvisi di ricerca e interruttori di funzionalità

Chiave opzione	Scopo
`as24ci_feature_search_agent`	Abilita gli avvisi di ricerca (Smart Stock Alerts).
`as24ci_feature_compare`	Pulsanti di confronto e pagina di confronto.
`as24ci_feature_favorites`	Preferiti / lista dei desideri.
`as24ci_feature_schema`	Metadati Schema.org e Open Graph sulle singole pagine.
`as24ci_feature_social_share`	Pulsanti di condivisione social.
`as24ci_social_share_placement`	Posizionamento dei pulsanti di condivisione social sulla singola pagina.
`as24ci_social_share_networks`	Social network attivi per i pulsanti di condivisione.
`as24ci_feature_sitemap`	Integrazione della sitemap.
`as24ci_feature_dashboard_widget`	Widget della bacheca di amministrazione.
`as24ci_feature_lazy_loading`	Caricamento differito delle immagini (lazy loading).
`as24ci_feature_bulk_actions`	Azioni di massa sull'elenco dei veicoli.
`as24ci_feature_export`	Esportazione CSV/JSON da Strumenti.
`as24ci_feature_pdf_datasheet`	Download della scheda tecnica PDF (interruttore principale per il pulsante del frontend "Scarica PDF").
`as24ci_pdf_manager_settings`	Array di impostazioni di branding, layout, QR e contenuti per l'output della scheda tecnica PDF. Indipendente da `as24ci_feature_pdf_datasheet`.

Analytics

Chiave opzione	Scopo
`as24ci_analytics_enabled`	Interruttore principale per il tracciamento delle statistiche.
`as24ci_analytics_bi_enabled`	Eventi estesi di BI (ricerche con filtri, aperture di contatti, invii di lead).
`as24ci_analytics_require_consent`	Blocca il tracciamento fino a quando non viene concesso il consenso del visitatore.
`as24ci_analytics_filter_minimization`	Rimuovi l'input di ricerca a testo libero prima di memorizzare gli eventi.
`as24ci_analytics_retention_days`	Finestra di conservazione per la tabella delle statistiche (predefinita `180`).
`as24ci_analytics_privacy_jurisdiction`	Etichetta della legge sulla privacy (`auto`, `gdpr`, `dsgvo`, `revdsg`, `uk_gdpr`, `generic`).

Confronto e finanziamento

Chiave opzione	Scopo
`as24ci_compare_max_vehicles`	Numero massimo di veicoli confrontati contemporaneamente. Limitato tra 2 e 8.
`as24ci_financing_enabled`	Abilita il calcolatore di finanziamento.
`as24ci_financing_default_rate`	Tasso di interesse annuo predefinito (%). Intervallo consentito 0–50.
`as24ci_financing_default_months`	Durata del prestito predefinita in mesi (`12`, `24`, `36`, `48`, `60`, `72`, `84`).
`as24ci_financing_down_payment`	Anticipo predefinito (%). Intervallo consentito 0–100.
`as24ci_financing_placement`	`below_gallery`, `sidebar` o `end_of_page`.

Design e layout

Il plugin espone un gran numero di opzioni di design sotto i prefissi as24ci_design_*, as24ci_single_*, as24ci_archive_*, as24ci_fav_*, as24ci_comp_* e as24ci_badge_*. Controllano i colori, la tipografia, la spaziatura, l'aspetto dei badge e il CSS personalizzato. Fare riferimento alle costanti in AS24CI\Options per l'elenco esaustivo.

Il layout a livello di pagina utilizza chiavi dedicate:

Chiave opzione	Scopo
`as24ci_layout_manager_enabled`	Interruttore principale per il Layout Manager.
`as24ci_lm_zone_`, `as24ci_lm_block_`	Configurazione per zona e per blocco.
`as24ci_layout_archive_columns`	Numero di colonne sulla griglia dell'archivio (1–4, predefinito 3).
`as24ci_archive_default_sort`	Ordinamento predefinito dell'archivio (`date_desc`, `price_asc`, `price_desc`, `mileage_asc`).
`as24ci_archive_per_page`	Veicoli visualizzati per pagina sull'archivio (predefinito 24).
`as24ci_archive_list_excerpt_length`	Numero massimo di caratteri dell'estratto nella vista Elenco (0–500, predefinito 75; `0` nasconde l'estratto).
`as24ci_layout_search_filters`	Blocchi di filtri attivi nella zona dei filtri di ricerca.
`as24ci_layout_single_main`, `as24ci_layout_single_sidebar`, `as24ci_layout_single_bottom`	Composizione della pagina del singolo veicolo.

Filtri e visibilità dei campi

Chiave opzione	Scopo
`as24ci_filters_enabled`	Array di chiavi di filtro abilitate per l'archivio pubblico (`null` significa tutte abilitate).
`as24ci_field_visibility`	Mappa di visibilità per vista per `car_details`, `sidebar`, `compare` e `favorites`.
`as24ci_mapping_overrides`	Sostituzioni di etichette e visibilità per campo per i campi AS24 importati (mappe serializzate `labels` / `visible`).

Hub API e sedi

Chiave opzione	Scopo
`as24ci_hub_api_key`	Chiave API per l'integrazione con Hub / Market Insights. Sensibile.
`as24ci_hub_target_market`	Codice del mercato di destinazione utilizzato dall'integrazione Hub.
`as24ci_locations`	Elenco serializzato delle sedi della concessionaria (nome, indirizzo, Seller ID, orari). Autoload disattivato.

CMH Team

Chiave opzione	Scopo
`as24ci_team_members`	Elenco serializzato dei membri del team della concessionaria gestiti dal plugin (contatti di vendita). Autoload disattivato.
`as24ci_team_location_defaults`	Mappa di AutoScout24 Seller ID → ID membro del team predefinito (contatto predefinito a livello di sede). Autoload disattivato.
`as24ci_team_standards`	Impostazioni di fallback globale / contatto generale della concessionaria (ID membro predefinito globale e dati di contatto generali). Autoload disattivato.
`as24ci_team_rules`	Flag di comportamento per l'assegnazione automatica per CMH Team. Autoload disattivato.

Monitoraggio della qualità dei dati

Chiave opzione	Scopo
`as24ci_dq_scan_enabled`	Interruttore principale.
`as24ci_dq_scan_frequency`	`daily` o `twicedaily`.
`as24ci_dq_scan_time`	Ora della prima esecuzione in `HH:00` (fuso orario del sito WordPress).
`as24ci_last_term_hash`, `as24ci_taxonomy_anomalies`	Stato della scansione interna.

Profilo del rivenditore

Raccolto dall'Installazione guidata e riutilizzato dalla scheda tecnica PDF, dai box di contatto, dai dati strutturati e dalle sedi. Memorizzato come opzioni semplici di livello principale.

Chiave opzione	Scopo
`as24ci_dealer_name`	Nome della concessionaria.
`as24ci_dealer_street`	Indirizzo stradale.
`as24ci_dealer_postal_code`	Codice postale/CAP.
`as24ci_dealer_city`	Città.
`as24ci_dealer_country`	Paese.
`as24ci_dealer_phone`	Numero di telefono.
`as24ci_dealer_email`	Email di contatto.
`as24ci_dealer_website`	URL del sito web.
`as24ci_dealer_logo_id`	ID allegato del logo della concessionaria.
`as24ci_dealer_language`	Lingua preferita del frontend (`site_default` o una localizzazione come `de_DE`).

Configurazione guidata

Chiave opzione	Scopo
`as24ci_setup_wizard_completed`	`1` una volta completata la configurazione guidata.
`as24ci_setup_wizard_skipped`	`1` se la configurazione guidata è stata saltata.
`as24ci_setup_mode`	Modalità di configurazione selezionata.
`as24ci_setup_completed_at`	Timestamp di completamento della configurazione.
`as24ci_setup_completed_by`	ID utente che ha completato la configurazione.
`as24ci_setup_first_activation_at`	Timestamp della prima attivazione del plugin.

ENVKV (Etichettatura energetica tedesca)

Chiave opzione	Scopo
`as24ci_envkv_year`	Anno di riferimento per il calcolo dei costi ENVKV.
`as24ci_envkv_price_petrol`, `as24ci_envkv_price_diesel`, `as24ci_envkv_price_electric`	Prezzi dell'energia per tipo di carburante.
`as24ci_envkv_co2_price_low`, `as24ci_envkv_co2_price_med`, `as24ci_envkv_co2_price_high`	Fasce di prezzo della CO₂.
`as24ci_envkv_show_costs_100km`	Mostra i costi stimati per 100 km.

Content Studio (opzionale)

Content Studio è un modulo delimitato con le proprie chiavi opzione (costanti in includes/class-as24ci-content-studio-options.php, AS24CI\Content_Studio_Options).

Chiave opzione	Scopo
`as24ci_content_studio_db_version`	Versione dello schema per le tabelle personalizzate di Content Studio.
`as24ci_content_studio_google_api_key`	Chiave API Google di proprietà del cliente utilizzata dal client di testo di Content Studio. Sensibile.
`as24ci_content_studio_default_language`	Lingua di output predefinita per i Copy Package generati.
`as24ci_content_studio_default_tone`	Tono predefinito per i Copy Package generati.
`as24ci_content_studio_brand_voice`	Suggerimento opzionale sullo stile della voce del brand del concessionario (max 800 caratteri).
`as24ci_content_studio_disclaimer_text`	Testo di esclusione di responsabilità obbligatorio opzionale per i testi generati (max 500 caratteri).
`as24ci_content_studio_compliance_notes`	Note di conformità opzionali per i testi generati (max 1000 caratteri).

Attivazione della licenza

Il plugin attiva e convalida nuovamente la sua licenza rispetto alla API Platform ADP Car Market Hub. Solo la chiave di licenza e il segreto del segnale di aggiornamento sono segreti (memorizzati crittografati a riposo tramite AS24CI\Secrets); ogni altra chiave contiene uno stato di licenza non segreto utilizzato per abilitare le funzionalità operative di scrittura.

Chiave opzione	Scopo
`as24ci_license_key`	Chiave di licenza crittografata della API Platform (busta dei segreti). Sensibile.
`as24ci_license_status`	Stato operativo della licenza (`License_Manager::STATUS_*`).
`as24ci_license_last_checked_at`	Timestamp Unix dell'ultima risposta corretta della API Platform (`0` = mai).
`as24ci_license_last_error`	Ultimo errore di licenza solo come codice stabile.
`as24ci_license_prefix`	Prefisso sicuro e non segreto della chiave di licenza restituito dalla API Platform.
`as24ci_license_plan`	Etichetta del piano di licenza.
`as24ci_license_support_until`	Timestamp ISO fino al quale il supporto è incluso (informativo).
`as24ci_license_expires_at`	Timestamp ISO in cui scade la licenza (informativo).
`as24ci_license_installation_uid`	UID di installazione rilasciato dalla API Platform all'attivazione.
`as24ci_license_manifest`	Oggetto manifesto non segreto restituito dalla API Platform.
`as24ci_license_feature_rights`	Mappa dei diritti sulle funzionalità restituita dalla API Platform.
`as24ci_license_import_policy`	Oggetto della politica di importazione restituito dalla API Platform.
`as24ci_license_normalized_domain`	Dominio normalizzato per cui la licenza è stata attivata/convalidata l'ultima volta.
`as24ci_license_last_reported_version`	Versione del plugin segnalata più di recente come confermata alla API Platform.
`as24ci_license_refresh_signal_secret`	Segreto condiviso crittografato per installazione utilizzato per autenticare i segnali di aggiornamento della licenza in entrata. Sensibile.

Credenziale AI gestita (sincronizzazione API Platform)

La credenziale Google Gemini del cliente viene fornita server-to-server dalla API Platform e gestita da AS24CI\Ai_Credential_Manager. La chiave Gemini è memorizzata solo in una busta crittografata; tutte le altre righe contengono metadati sicuri per la scheda di stato dell'amministratore.

Chiave opzione	Scopo
`as24ci_ai_credential_envelope`	Busta crittografata delle credenziali Gemini. Mai caricata automaticamente, mai renderizzata. Sensibile.
`as24ci_ai_credential_provider`	Valore grezzo del provider restituito dalla API Platform (ad es. `google` / `gemini`).
`as24ci_ai_credential_display_provider`	Etichetta del provider rivolta al cliente (sempre "Google Gemini").
`as24ci_ai_credential_api_model`	Modello esattamente come segnalato dalla API Platform.
`as24ci_ai_credential_effective_model`	Modello Gemini di runtime effettivo dopo la convalida/fallback.
`as24ci_ai_credential_fingerprint`	Impronta digitale non segreta della credenziale fornita (marcatore di rotazione).
`as24ci_ai_credential_synced_at`	Timestamp Unix dell'ultima sincronizzazione riuscita delle credenziali.
`as24ci_ai_credential_checked_at`	Timestamp Unix dell'ultimo tentativo di sincronizzazione.
`as24ci_ai_credential_status`	Stringa di stato della disponibilità dell'AI locale.
`as24ci_ai_credential_last_error`	Ultimo codice di errore di sincronizzazione/motivo della decisione non sensibile.
`as24ci_ai_usage_reporting_required`	Se la API Platform richiede la segnalazione dell'utilizzo dell'AI.

Aggiornamenti e visibilità degli aggiornamenti

Gestione sicura e non segreta per il flusso di aggiornamento privato. Nessuna di queste righe viene caricata automaticamente e nessuna memorizza un URL del pacchetto firmato, una firma, un segreto o una chiave di licenza.

Chiave opzione	Scopo
`as24ci_update_last_check_diag`	Ultima diagnostica del controllo dell'aggiornamento privato (solo metadati non segreti).
`as24ci_update_visibility_last_refresh_at`	Timestamp Unix dell'ultimo tentativo di aggiornamento della visibilità.
`as24ci_update_visibility_last_refresh_reason`	Codice motivo stabile per l'ultima decisione di aggiornamento.
`as24ci_update_visibility_last_refresh_result`	Risultato dell'ultimo tentativo di aggiornamento (`refreshed` o `skipped`).
`as24ci_update_visibility_last_skip_reason`	Codice motivo stabile per l'ultimo aggiornamento saltato.
`as24ci_update_visibility_last_inconsistency_refresh_at`	Timestamp dell'ultimo aggiornamento attivato per riparare uno stato transitorio incoerente.
`as24ci_update_last_transient_snapshot`	Snapshot piccolo e sicuro del transitorio `update_plugins` per questo plugin.

Tracciamento dello schema e della migrazione

Chiave opzione	Scopo
`as24ci_db_version`	Versione complessiva dei dati del plugin.
`as24ci_caps_version`	Versione della migrazione dei ruoli/funzionalità.
`as24ci_vehicles_db_version`, `as24ci_search_agent_db_version`, `as24ci_analytics_db_version`	Versioni dello schema per singola tabella.

Non modificarle manualmente a meno che non si intenda forzare una nuova migrazione.

Note operative

Valori sensibili. Trattare as24ci_client_secret, as24ci_cron_token, as24ci_webhook_secret, as24ci_hub_api_key e as24ci_content_studio_google_api_key come credenziali. Non eseguirne il commit nel controllo del codice sorgente né visualizzarli nei template o nei log. Le opzioni crittografate a riposo as24ci_license_key, as24ci_license_refresh_signal_secret e as24ci_ai_credential_envelope sono memorizzate tramite AS24CI\Secrets. La chiave Gemini gestita fornita a runtime è di proprietà di AD Promotion in AS24CI\Ai_Config e non viene memorizzata come opzione WordPress in testo non crittografato.
Codifica booleana. La maggior parte dei selettori booleani è memorizzata come stringhe '1' e '0'. Confrontare con stringhe o eseguire il cast tramite (string) prima di confrontare.
Filtraggio a runtime. I filtri standard di WordPress (option_<key>, pre_option_<key>, default_option_<key>) funzionano per qualsiasi opzione qui presente. Questo è il modo consigliato per sovrascrivere i valori al momento del deploy senza scrivere nel database.
Multisito. Tutte le chiavi sopra indicate sono per singolo sito. Configurale su ciascun sito individualmente a meno che non sia attiva un'automazione a livello di rete.
Valori predefiniti. I valori predefiniti sono applicati nel codice. I valori predefiniti esatti possono variare tra le versioni; verificare rispetto al codice sorgente corrente prima della pubblicazione.