Documentatie · Bijlagen

Instellingenreferentie

Deze bijlage is een referentielijst van de optiesleutels die de ADP Car Market Hub-plugin leest en schrijft.

Wanneer u dit document moet gebruiken

Gebruik deze referentie wanneer u de optiesleutel achter een beheerdersveld wilt opzoeken, wanneer u programmatisch een waarde wilt lezen met get_option(), of wanneer u een implementatie controleert. Zie Settings Reference (Admin) voor de configuratie-UI. Zie Option Keys And Settings Storage voor het conceptuele opslagmodel.

Overzicht

Alle plugin-opties worden opgeslagen in wp_options met het voorvoegsel as24ci_. Booleaanse schakelaars worden opgeslagen als de strings '1' (ingeschakeld) and '0' (uitgeschakeld), tenzij anders vermeld. De canonieke sleutels zijn gedefinieerd als constanten in includes/class-as24ci-options.php (AS24CI\Options); geef altijd de voorkeur aan de constanten uit PHP.

De plugin registreert geen opties via de WordPress Settings API. Elk beheerders-tabblad slaat zijn eigen opties op via speciale handlers die zijn beveiligd met capaciteits- en nonce-controles.

API en authenticatie

Optiesleutel	Doel
`as24ci_base_url`	Basis-URL van de data-API (meestal een AutoScout24-eindpunt of een door de klant geleverde proxy).
`as24ci_token_url`	OAuth-token-eindpunt.
`as24ci_token_audience`	JWT-audience-waarde. Automatisch afgeleid van de geconfigureerde basis-URL wanneer deze niet expliciet is ingesteld.
`as24ci_client_id`	OAuth Client ID.
`as24ci_client_secret`	OAuth client-geheim. Gevoelig. Onversleuteld opgeslagen; behandelen als inloggegeven.
`as24ci_seller_ids`	Een of meer Seller IDs (array of door komma's gescheiden string in de invoer).
`as24ci_default_currency`	Standaard ISO 4217-valutacode die wordt gebruikt wanneer er geen valuta per voertuig wordt meegeleverd.

Importgedrag

Optiesleutel	Doel
`as24ci_default_post_status`	Initiële berichtstatus voor nieuw geïmporteerde voertuigen.
`as24ci_default_post_author`	Gebruikers-ID die wordt gebruikt als auteur voor nieuw geïmporteerde voertuigen.
`as24ci_import_images`	Afbeeldingenimport inschakelen.
`as24ci_max_images`	Maximaal aantal afbeeldingen per voertuig (`0` = onbeperkt).
`as24ci_convert_to_webp`	Geïmporteerde afbeeldingen converteren naar WebP (vereist GD of Imagick).
`as24ci_webp_quality`	WebP-kwaliteit (1–100, standaard `80`).
`as24ci_full_sync`	Lokale voertuigen die ontbreken in de externe feed aan het einde van elke run verwijderen. Opt-in.
`as24ci_verbose_logging`	Extra details per veld en per afbeelding loggen tijdens imports.

Planner en automatisering

Optiesleutel	Doel
`as24ci_auto_import_enabled`	Hoofdschakelaar voor de WP-Cron-importgebeurtenis.
`as24ci_cron_schedule`	Planningssleutel: `hourly`, `as24ci_every_6_hours`, `twicedaily`, `daily`, `as24ci_custom`.
`as24ci_cron_start_time`	Starttijd in `HH:MM` (24-uurs, WordPress tijdzone van de site) voor `daily` en `twicedaily`.
`as24ci_cron_custom_minutes`	Interval in minuten voor `as24ci_custom`. Begrensd op een minimum van `15`.
`as24ci_cron_mode`	`wp-cron` of `server-cron`. Stuurt hints in de beheerders-UI aan.
`as24ci_cron_token`	Token voor het `cron-import` REST-eindpunt. Gevoelig. Een lege waarde schakelt het eindpunt uit.
`as24ci_cron_max_vehicles`	Maximaal aantal verwerkte voertuigen per cron- / REST-run (`0` = onbeperkt).
`as24ci_cron_image_queue`	Gebruik de afbeeldingenwachtrij tijdens cron- / REST-runs.
`as24ci_last_run_time`	Unix-timestamp van de laatst voltooide run.
`as24ci_last_run_status`	Array met tellingen van de laatste run.
`as24ci_last_run_manual`	`1` als de laatste run handmatig is geactiveerd.
`as24ci_last_external_cron_run`	Unix-timestamp van de laatste `?as24ci_cron=1`-ping.

REST API

Optiesleutel	Doel
`as24ci_rest_api_enabled`	Indien `'1'`, registreert de openbare `/vehicles`- en `/vehicles/{id}`-routes. Standaard `'0'`.

Standaardpagina's en deïnstallatie

Optiesleutel	Doel
`as24ci_create_default_pages`	Indien aangevinkt op het moment van opslaan, maakt de plugin de pagina's Cars, Compare en Favorites aan als deze ontbreken. Bestaande pagina's worden niet overschreven.
`as24ci_page_archive_id`	Pagina-ID van de bij activering aangemaakte Cars-pagina.
`as24ci_page_compare_id`	Pagina-ID van de bij activering aangemaakte Compare-pagina.
`as24ci_page_favorites_id`	Pagina-ID van de bij activering aangemaakte Favorites-pagina.
`as24ci_delete_data_on_uninstall`	Indien `'1'`, verwijdert de deïnstallatie voertuigen, leads, geïmporteerde bijlagen en de bij activering aangemaakte pagina's.

Leadverwerking en contactformulier

Optiesleutel	Doel
`as24ci_lead_recipient_email`	Ontvangers-e-mailadres overschrijven voor leadmeldingen.
`as24ci_lead_field_name`, `as24ci_lead_field_email`, `as24ci_lead_field_phone`, `as24ci_lead_field_message`	Schakelaars voor zichtbaarheid per veld voor het contactformulier.
`as24ci_lead_consent_enabled`, `as24ci_lead_consent_text`, `as24ci_lead_privacy_url`	Configuratie van het toestemmingsselectievakje.
`as24ci_lead_msg_success`, `as24ci_lead_msg_error`	Statusberichten aan de frontend.
`as24ci_lead_email_subject_dealer`, `as24ci_lead_email_subject_customer`, `as24ci_lead_email_template_dealer`, `as24ci_lead_email_template_customer`	E-mailsjablonen voor meldingen.

Webhooks

Optiesleutel	Doel
`as24ci_webhook_url_new_lead`	Doel-URL voor de `new_lead`-gebeurtenis. Leeg schakelt de gebeurtenis uit.
`as24ci_webhook_url_new_import`	Doel-URL voor de `new_import`-gebeurtenis. Leeg schakelt de gebeurtenis uit.
`as24ci_webhook_secret`	HMAC-SHA256-handtekeninggeheim. Gevoelig. Leeg schakelt ondertekening uit.

AI Assistant (optioneel)

AI-functies maken gebruik van de beheerde Google Gemini-configuratie in ADP Car Market Hub. Er bestaat geen optie voor provider, model of API-sleutel in wp_options. De beheerde Gemini-sleutel en het model zijn PHP-constanten op AS24CI\Ai_Config (MANAGED_GEMINI_API_KEY, MANAGED_GEMINI_MODEL) die na installatie door AD Promotion worden verstrekt.

Optiesleutel	Doel
`as24ci_ai_assistant_enabled`	Hoofdschakelaar.
`as24ci_ai_assistant_language`, `as24ci_ai_assistant_tone`, `as24ci_ai_assistant_max_length`	Generatieparameters.
`as24ci_ai_assistant_auto_generate`	Automatisch beschrijvingen genereren bij import.
`as24ci_ai_assistant_custom_prompt`	Optioneel aangepast promptsjabloon.
`as24ci_ai_gen_alt_text`, `as24ci_ai_gen_seo`, `as24ci_ai_extract_highlights`	Aanvullende schakelaars voor automatische generatie.

Proefrit boeken (optioneel)

Optiesleutel	Doel
`as24ci_test_drive_enabled`	Hoofdschakelaar.
`as24ci_test_drive_available_days`	Door komma's gescheiden weekdagnummers (`0` = zondag).
`as24ci_test_drive_start_time`, `as24ci_test_drive_end_time`	Dagelijks tijdsbestek in `HH:MM`.
`as24ci_test_drive_slot_duration`	Duur van het tijdslot in minuten.
`as24ci_test_drive_blackout_dates`	Geserialiseerde lijst met uitgesloten datums.

Zoekalerts en functieschakelaars

Optiesleutel	Doel
`as24ci_feature_search_agent`	Zoekalerts (Smart Stock Alerts) inschakelen.
`as24ci_feature_compare`	Vergelijkingsknoppen en vergelijkingspagina.
`as24ci_feature_favorites`	Favorieten/verlanglijst.
`as24ci_feature_schema`	Schema.org- en Open Graph-metadata op detailpagina's.
`as24ci_feature_social_share`	Knoppen voor delen op sociale media.
`as24ci_social_share_placement`	Plaatsing van de knoppen voor delen op sociale media op de detailpagina.
`as24ci_social_share_networks`	Actieve sociale netwerken voor de deelknoppen.
`as24ci_feature_sitemap`	Sitemap-integratie.
`as24ci_feature_dashboard_widget`	Widget voor het beheerdersdashboard.
`as24ci_feature_lazy_loading`	Lazy loading van afbeeldingen.
`as24ci_feature_bulk_actions`	Bulkacties op de voertuiglijst.
`as24ci_feature_export`	CSV/JSON-export vanuit Gereedschap.
`as24ci_feature_pdf_datasheet`	PDF datasheet-download (hoofdschakelaar voor de frontend-knop "PDF downloaden").
`as24ci_pdf_manager_settings`	Array van branding-, lay-out-, QR- en inhoudsinstellingen voor de PDF datasheet-uitvoer. Onafhankelijk van `as24ci_feature_pdf_datasheet`.

Analytics

Optiesleutel	Doel
`as24ci_analytics_enabled`	Hoofdschakelaar voor het bijhouden van statistieken.
`as24ci_analytics_bi_enabled`	Uitgebreide BI-gebeurtenissen (zoekopdrachten filteren, contactgegevens openen, leads verzenden).
`as24ci_analytics_require_consent`	Tracking blokkeren totdat de bezoeker toestemming heeft gegeven.
`as24ci_analytics_filter_minimization`	Vrije tekstzoekinvoer opschonen voordat gebeurtenissen worden opgeslagen.
`as24ci_analytics_retention_days`	Bewaartermijn voor de analyticstabel (standaard `180`).
`as24ci_analytics_privacy_jurisdiction`	Label voor privacywetgeving (`auto`, `gdpr`, `dsgvo`, `revdsg`, `uk_gdpr`, `generic`).

Vergelijken en financiering

Optiesleutel	Doel
`as24ci_compare_max_vehicles`	Maximaal aantal voertuigen dat tegelijkertijd wordt vergeleken. Begrensd tussen 2 en 8.
`as24ci_financing_enabled`	De financieringscalculator inschakelen.
`as24ci_financing_default_rate`	Standaard jaarlijkse rentevoet (%). Toegestaan bereik 0–50.
`as24ci_financing_default_months`	Standaard looptijd van de lening in maanden (`12`, `24`, `36`, `48`, `60`, `72`, `84`).
`as24ci_financing_down_payment`	Standaard aanbetaling (%). Toegestaan bereik 0–100.
`as24ci_financing_placement`	`below_gallery`, `sidebar` of `end_of_page`.

Ontwerp en lay-out

De plugin biedt een groot aantal ontwerpopties onder de voorvoegsels as24ci_design_*, as24ci_single_*, as24ci_archive_*, as24ci_fav_*, as24ci_comp_* en as24ci_badge_*. Deze bepalen kleuren, typografie, spatiëring, de weergave van badges en aangepaste CSS. Raadpleeg de constanten in AS24CI\Options voor de volledige lijst.

De lay-out op paginaniveau maakt gebruik van specifieke sleutels:

Optiesleutel	Doel
`as24ci_layout_manager_enabled`	Hoofdschakelaar voor de Layout Manager.
`as24ci_lm_zone_`, `as24ci_lm_block_`	Configuratie per zone en per blok.
`as24ci_layout_archive_columns`	Aantal kolommen op het archiefraster (1–4, standaard 3).
`as24ci_archive_default_sort`	Standaard sorteervolgorde voor het archief (`date_desc`, `price_asc`, `price_desc`, `mileage_asc`).
`as24ci_archive_per_page`	Aantal weergegeven voertuigen per pagina in het archief (standaard 24).
`as24ci_archive_list_excerpt_length`	Maximaal aantal tekens voor de samenvatting in de lijstweergave (0–500, standaard 75; `0` verbergt de samenvatting).
`as24ci_layout_search_filters`	Actieve filterblokken in de zone voor zoekfilters.
`as24ci_layout_single_main`, `as24ci_layout_single_sidebar`, `as24ci_layout_single_bottom`	Pagina-opbouw voor een enkel voertuig.

Filters en veldzichtbaarheid

Optiesleutel	Doel
`as24ci_filters_enabled`	Array van ingeschakelde filtersleutels voor het openbare archief (`null` betekent alle ingeschakeld).
`as24ci_field_visibility`	Zichtbaarheidskaart per weergave voor `car_details`, `sidebar`, `compare` en `favorites`.
`as24ci_mapping_overrides`	Overschrijvingen van labels en zichtbaarheid per veld voor geïmporteerde AS24-velden (geserialiseerde `labels`- / `visible`-kaarten).

Hub API en locaties

Optiesleutel	Doel
`as24ci_hub_api_key`	API-sleutel voor de Hub / Market Insights-integratie. Gevoelig.
`as24ci_hub_target_market`	Doelmarktcode die wordt gebruikt door de Hub-integratie.
`as24ci_locations`	Geserialiseerde lijst van dealerlocaties (naam, adres, Seller IDs, openingstijden). Autoload uit.

CMH Team

Optiesleutel	Doel
`as24ci_team_members`	Geserialiseerde lijst van door de plugin beheerde teamleden van de dealer (verkoopcontacten). Autoload uit.
`as24ci_team_location_defaults`	Koppeling van AutoScout24 Seller ID → standaard teamlid-ID (standaardcontactpersoon op locatieniveau). Autoload uit.
`as24ci_team_standards`	Wereldwijde terugvaloptie / algemene contactinstellingen voor de dealer (wereldwijde standaard teamlid-ID en algemene contactgegevens). Autoload uit.
`as24ci_team_rules`	Vlaggen voor automatisch toewijzingsgedrag voor CMH Team. Autoload uit.

Toezicht op datakwaliteit

Optiesleutel	Doel
`as24ci_dq_scan_enabled`	Hoofdschakelaar.
`as24ci_dq_scan_frequency`	`daily` of `twicedaily`.
`as24ci_dq_scan_time`	Tijdstip van de eerste run in `HH:00` (WordPress tijdzone van de site).
`as24ci_last_term_hash`, `as24ci_taxonomy_anomalies`	Interne scanstatus.

Dealerprofiel

Verzameld door de Setup Wizard en hergebruikt door de PDF datasheet, contactvakken, gestructureerde gegevens en locaties. Opgeslagen als eenvoudige opties op het hoogste niveau.

Optiesleutel	Doel
`as24ci_dealer_name`	Naam van de dealer.
`as24ci_dealer_street`	Straatnaam en huisnummer.
`as24ci_dealer_postal_code`	Postcode.
`as24ci_dealer_city`	Plaats.
`as24ci_dealer_country`	Land.
`as24ci_dealer_phone`	Telefoonnummer.
`as24ci_dealer_email`	Contact-e-mailadres.
`as24ci_dealer_website`	Website-URL.
`as24ci_dealer_logo_id`	Bijlage-ID van het dealerlogo.
`as24ci_dealer_language`	Voorkeurstaal voor de frontend (`site_default` of een taalcode zoals `de_DE`).

Setup Wizard

Optiesleutel	Doel
`as24ci_setup_wizard_completed`	`1` zodra de setup wizard is voltooid.
`as24ci_setup_wizard_skipped`	`1` als de setup wizard is overgeslagen.
`as24ci_setup_mode`	Geselecteerde setup-modus.
`as24ci_setup_completed_at`	Tijdstempel wanneer de setup is voltooid.
`as24ci_setup_completed_by`	Gebruikers-ID die de setup heeft voltooid.
`as24ci_setup_first_activation_at`	Tijdstempel van de eerste plugin-activatie.

EnVKV (Duitse energielabeling)

Optiesleutel	Doel
`as24ci_envkv_year`	Referentiejaar voor de EnVKV-kostenberekening.
`as24ci_envkv_price_petrol`, `as24ci_envkv_price_diesel`, `as24ci_envkv_price_electric`	Energieprijzen per brandstoftype.
`as24ci_envkv_co2_price_low`, `as24ci_envkv_co2_price_med`, `as24ci_envkv_co2_price_high`	CO₂-prijsschalen.
`as24ci_envkv_show_costs_100km`	Toon geschatte kosten per 100 km.

Content Studio (optioneel)

Content Studio is een begrensde module met eigen optiesleutels (constanten in includes/class-as24ci-content-studio-options.php, AS24CI\Content_Studio_Options).

Optiesleutel	Doel
`as24ci_content_studio_db_version`	Schemaversie voor de aangepaste tabellen van de Content Studio.
`as24ci_content_studio_google_api_key`	Google API-sleutel van de klant die wordt gebruikt door de Content Studio-tekstclient. Gevoelig.
`as24ci_content_studio_default_language`	Standaard uitvoertaal voor gegenereerde Copy Packages.
`as24ci_content_studio_default_tone`	Standaard toon voor gegenereerde Copy Packages.
`as24ci_content_studio_brand_voice`	Optionele stijlaanwijzing voor de merkstem van de dealer (max. 800 tekens).
`as24ci_content_studio_disclaimer_text`	Optionele verplichte disclaimertekst voor gegenereerde teksten (max. 500 tekens).
`as24ci_content_studio_compliance_notes`	Optionele nalevingsopmerkingen voor gegenereerde teksten (max. 1000 tekens).

Licentie-activatie

De plugin activeert en valideert zijn licentie opnieuw tegen het ADP Car Market Hub API Platform. Alleen de licentiesleutel en het geheim voor het vernieuwingssignaal zijn geheimen (versleuteld opgeslagen via AS24CI\Secrets); elke andere sleutel bevat een niet-geheime licentiestatus die wordt gebruikt om operationele schrijffuncties te beheren.

Optiesleutel	Doel
`as24ci_license_key`	Versleutelde API Platform-licentiesleutel (Secrets-envelop). Gevoelig.
`as24ci_license_status`	Operationele licentiestatus (`License_Manager::STATUS_*`).
`as24ci_license_last_checked_at`	Unix-tijdstempel van het laatste succesvolle API Platform-antwoord (`0` = nooit).
`as24ci_license_last_error`	Laatste licentiefout, uitsluitend als stabiele code.
`as24ci_license_prefix`	Veilig, niet-geheim voorvoegsel van de licentiesleutel geretourneerd door het API Platform.
`as24ci_license_plan`	Label van het licentiepakket.
`as24ci_license_support_until`	ISO-tijdstempel tot wanneer ondersteuning is inbegrepen (informatief).
`as24ci_license_expires_at`	ISO-tijdstempel waarop de licentie verloopt (informatief).
`as24ci_license_installation_uid`	Installatie-UID uitgegeven door het API Platform bij activatie.
`as24ci_license_manifest`	Niet-geheim manifest-object geretourneerd door het API Platform.
`as24ci_license_feature_rights`	Overzicht van functierechten geretourneerd door het API Platform.
`as24ci_license_import_policy`	Import-policy-object geretourneerd door het API Platform.
`as24ci_license_normalized_domain`	Genormaliseerd domein waarvoor de licentie het laatst is geactiveerd/gevalideerd.
`as24ci_license_last_reported_version`	Plugin-versie die het meest recent als gerapporteerd is bevestigd aan het API Platform.
`as24ci_license_refresh_signal_secret`	Versleuteld gedeeld geheim per installatie dat wordt gebruikt om inkomende licentievernieuwingssignalen te authenticeren. Gevoelig.

Beheerde AI-inloggegevens (API Platform-synchronisatie)

De Google Gemini-inloggegevens van de klant worden server-to-server geleverd door het API Platform en beheerd door AS24CI\Ai_Credential_Manager. De Gemini-sleutel wordt alleen opgeslagen in een versleutelde envelop; alle andere rijen bevatten veilige metadata voor de statuskaart van de beheerder.

Optiesleutel	Doel
`as24ci_ai_credential_envelope`	Versleutelde Gemini-inloggegevens-envelop. Wordt nooit automatisch geladen, nooit gerenderd. Gevoelig.
`as24ci_ai_credential_provider`	Onbewerkte providerwaarde geretourneerd door het API Platform (bijv. `google` / `gemini`).
`as24ci_ai_credential_display_provider`	Klantgericht providerlabel (altijd "Google Gemini").
`as24ci_ai_credential_api_model`	Model exact zoals gerapporteerd door het API Platform.
`as24ci_ai_credential_effective_model`	Effectief runtime Gemini-model na validatie/fallback.
`as24ci_ai_credential_fingerprint`	Niet-geheime vingerafdruk van de geleverde inloggegevens (rotatiemarkering).
`as24ci_ai_credential_synced_at`	Unix-tijdstempel van de laatste succesvolle synchronisatie van inloggegevens.
`as24ci_ai_credential_checked_at`	Unix-tijdstempel van de laatste synchronisatiepoging.
`as24ci_ai_credential_status`	Lokale statusstring voor AI-beschikbaarheid.
`as24ci_ai_credential_last_error`	Laatste niet-gevoelige synchronisatiefout/beslissingsredencode.
`as24ci_ai_usage_reporting_required`	Of het API Platform rapportage van AI-gebruik vereist.

Updates en update-zichtbaarheid

Veilige, niet-geheime boekhouding voor de private update-stroom. Geen van deze rijen wordt automatisch geladen, en geen enkele slaat een ondertekende pakket-URL, handtekening, geheim of licentiesleutel op.

Optiesleutel	Doel
`as24ci_update_last_check_diag`	Diagnostische gegevens van de laatste private-updatecontrole (alleen niet-gevoelige metadata).
`as24ci_update_visibility_last_refresh_at`	Unix-tijdstempel van de laatste poging tot het vernieuwen van de zichtbaarheid.
`as24ci_update_visibility_last_refresh_reason`	Stabiele redencode voor de laatste vernieuwingsbeslissing.
`as24ci_update_visibility_last_refresh_result`	Resultaat van de laatste vernieuwingspoging (`refreshed` of `skipped`).
`as24ci_update_visibility_last_skip_reason`	Stabiele redencode voor de laatste overgeslagen vernieuwing.
`as24ci_update_visibility_last_inconsistency_refresh_at`	Tijdstempel van de laatste vernieuwing die is geactiveerd om een inconsistente tijdelijke status te herstellen.
`as24ci_update_last_transient_snapshot`	Kleine, veilige momentopname van de `update_plugins` transient voor deze plugin.

Schema- en migratie-tracking

Optiesleutel	Doel
`as24ci_db_version`	Algehele plugin-dataversie.
`as24ci_caps_version`	Migratieversie voor mogelijkheden/rollen.
`as24ci_vehicles_db_version`, `as24ci_search_agent_db_version`, `as24ci_analytics_db_version`	Schemaversies per tabel.

Bewerk deze niet handmatig, tenzij u een hernieuwde migratie wilt afdwingen.

Operationele opmerkingen

Gevoelige waarden. Behandel as24ci_client_secret, as24ci_cron_token, as24ci_webhook_secret, as24ci_hub_api_key en as24ci_content_studio_google_api_key als inloggegevens. Leg ze niet vast in versiebeheer en toon ze niet in templates of logs. De versleuteld opgeslagen opties as24ci_license_key, as24ci_license_refresh_signal_secret en as24ci_ai_credential_envelope worden opgeslagen via AS24CI\Secrets. De beheerde Gemini-sleutel die tijdens runtime wordt geleverd, is eigendom van AD Promotion in AS24CI\Ai_Config en wordt niet opgeslagen als een platte tekst WordPress-optie.
Booleaanse codering. De meeste booleaanse schakelaars worden opgeslagen als de strings '1' en '0'. Vergelijk met strings of cast via (string) alvorens te vergelijken.
Filteren tijdens runtime. Standaard WordPress-filters (option_<key>, pre_option_<key>, default_option_<key>) werken voor elke optie hier. Dit is de aanbevolen manier om waarden te overschrijven tijdens de implementatie zonder naar de database te schrijven.
Multisite. Alle bovenstaande sleutels zijn per site. Richt ze op elke site afzonderlijk in, tenzij u een netwerkbrede automatisering heeft ingesteld.
Standaardwaarden. Standaardwaarden worden in de code toegepast. De exacte standaardwaarden kunnen tussen releases veranderen; controleer dit aan de hand van de huidige broncode voordat u publiceert.