Dokumentation · Anhänge

Einstellungsreferenz

Dieser Anhang ist eine Referenzliste der Option-Keys, die das ADP Car Market Hub-Plugin liest und schreibt.

Wann Sie dieses Dokument verwenden sollten

Verwenden Sie diese Referenz, wenn Sie den Option-Key hinter einem Admin-Feld nachschlagen müssen, wenn Sie einen Wert programmatisch mit get_option() auslesen möchten oder wenn Sie eine Bereitstellung überprüfen. Informationen zur Konfigurationsoberfläche finden Sie unter Settings Reference (Admin). Zum konzeptionellen Speichermodell siehe Option Keys And Settings Storage.

Übersicht

Alle Plugin-Optionen werden in wp_options mit dem Präfix as24ci_ gespeichert. Boolesche Schalter werden als die Strings '1' (aktiviert) und '0' (deaktiviert) gespeichert, sofern nicht anders angegeben. Die kanonischen Keys sind als Konstanten in includes/class-as24ci-options.php (AS24CI\Options) definiert; bevorzugen Sie immer die Konstanten aus PHP.

Das Plugin registriert keine Optionen über die WordPress-Settings-API. Jeder Admin-Tab speichert seine eigenen Optionen über dedizierte Handler, die durch Berechtigungs- und Nonce-Prüfungen geschützt sind.

API und Authentifizierung

Option-KeyZweck
as24ci_base_urlBasis-URL der Daten-API (normalerweise ein AutoScout24-Endpunkt oder ein vom Kunden bereitgestellter Proxy).
as24ci_token_urlOAuth-Token-Endpunkt.
as24ci_token_audienceJWT-Audience-Wert. Wird automatisch aus der konfigurierten Basis-URL abgeleitet, wenn er nicht explizit gesetzt ist.
as24ci_client_idOAuth-Client-ID.
as24ci_client_secretOAuth-Client-Secret. Sensibel. Unverschlüsselt gespeichert; wie ein Zugangsdaten-Passwort behandeln.
as24ci_seller_idsEine oder mehrere Seller-IDs (Array oder kommagetrennter String in der Eingabe).
as24ci_default_currencyStandard-ISO-4217-Währungscode, der verwendet wird, wenn keine fahrzeugspezifische Währung angegeben ist.

Importverhalten

Option-KeyZweck
as24ci_default_post_statusInitialer Beitragsstatus für neu importierte Fahrzeuge.
as24ci_default_post_authorBenutzer-ID, die als Autor für neu importierte Fahrzeuge verwendet wird.
as24ci_import_imagesBildimport aktivieren.
as24ci_max_imagesMaximale Anzahl an Bildern pro Fahrzeug (0 = unbegrenzt).
as24ci_convert_to_webpImportierte Bilder in WebP konvertieren (erfordert GD oder Imagick).
as24ci_webp_qualityWebP-Qualität (1–100, Standard 80).
as24ci_full_syncLokale Fahrzeuge am Ende jedes Durchlaufs löschen, die im Remote-Feed fehlen. Opt-in.
as24ci_verbose_loggingZusätzliche Details pro Feld und pro Bild während des Imports protokollieren.

Scheduler und Automatisierung

Option-KeyZweck
as24ci_auto_import_enabledHauptschalter für das WP-Cron-Import-Event.
as24ci_cron_scheduleZeitplan-Key: hourly, as24ci_every_6_hours, twicedaily, daily, as24ci_custom.
as24ci_cron_start_timeStartzeit in HH:MM (24 Std., WordPress Website-Zeitzone) für daily und twicedaily.
as24ci_cron_custom_minutesIntervall in Minuten für as24ci_custom. Begrenzt auf ein Minimum von 15.
as24ci_cron_modewp-cron oder server-cron. Steuert die Hinweise in der Admin-Oberfläche.
as24ci_cron_tokenToken für den cron-import REST-Endpunkt. Sensibel. Ein leerer Wert deaktiviert den Endpunkt.
as24ci_cron_max_vehiclesMaximale Anzahl an Fahrzeugen, die pro Cron- / REST-Durchlauf verarbeitet werden (0 = unbegrenzt).
as24ci_cron_image_queueBild-Warteschlange während Cron- / REST-Durchläufen verwenden.
as24ci_last_run_timeUnix-Timestamp des letzten abgeschlossenen Durchlaufs.
as24ci_last_run_statusZähler-Array des letzten Durchlaufs.
as24ci_last_run_manual1, wenn der letzte Durchlauf manuell ausgelöst wurde.
as24ci_last_external_cron_runUnix-Timestamp des letzten ?as24ci_cron=1-Pings.

REST-API

Option-KeyZweck
as24ci_rest_api_enabledWenn '1', werden die öffentlichen Routen /vehicles und /vehicles/{id} registriert. Standard '0'.

Standardseiten und Deinstallation

Option-KeyZweck
as24ci_create_default_pagesWenn beim Speichern aktiviert, erstellt das Plugin die Seiten „Fahrzeuge“, „Vergleichen“ und „Favoriten“, falls diese fehlen. Bestehende Seiten werden nicht überschrieben.
as24ci_page_archive_idSeiten-ID der bei der Aktivierung erstellten Fahrzeugseite.
as24ci_page_compare_idSeiten-ID der bei der Aktivierung erstellten Vergleichsseite.
as24ci_page_favorites_idSeiten-ID der bei der Aktivierung erstellten Favoritenseite.
as24ci_delete_data_on_uninstallWenn '1', entfernt die Deinstallation Fahrzeuge, Leads, importierte Anhänge und die bei der Aktivierung erstellten Seiten.

Lead-Verarbeitung und Kontaktformular

Option-KeyZweck
as24ci_lead_recipient_emailEmpfänger-E-Mail für Lead-Benachrichtigungen überschreiben.
as24ci_lead_field_name, as24ci_lead_field_email, as24ci_lead_field_phone, as24ci_lead_field_messageSchalter für die Sichtbarkeit einzelner Felder im Kontaktformular.
as24ci_lead_consent_enabled, as24ci_lead_consent_text, as24ci_lead_privacy_urlKonfiguration der Einverständnis-Checkbox.
as24ci_lead_msg_success, as24ci_lead_msg_errorFrontend-Statusmeldungen.
as24ci_lead_email_subject_dealer, as24ci_lead_email_subject_customer, as24ci_lead_email_template_dealer, as24ci_lead_email_template_customerE-Mail-Vorlagen für Benachrichtigungen.

Webhooks

Option-KeyZweck
as24ci_webhook_url_new_leadZiel-URL für das new_lead-Event. Leer deaktiviert das Event.
as24ci_webhook_url_new_importZiel-URL für das new_import-Event. Leer deaktiviert das Event.
as24ci_webhook_secretHMAC-SHA256-Signaturgeheimnis. Sensibel. Leer deaktiviert die Signierung.

KI-Assistent (optional)

KI-Funktionen nutzen die verwaltete Google Gemini-Konfiguration in ADP Car Market Hub. Es gibt keine Option für Anbieter, Modell oder API-Key in wp_options. Der verwaltete Gemini-Key und das Modell sind PHP-Konstanten auf AS24CI\Ai_Config (MANAGED_GEMINI_API_KEY, MANAGED_GEMINI_MODEL), die von AD Promotion nach der Installation bereitgestellt werden.

Option-KeyZweck
as24ci_ai_assistant_enabledHauptschalter.
as24ci_ai_assistant_language, as24ci_ai_assistant_tone, as24ci_ai_assistant_max_lengthGenerierungsparameter.
as24ci_ai_assistant_auto_generateBeschreibungen beim Import automatisch generieren.
as24ci_ai_assistant_custom_promptOptionale benutzerdefinierte Prompt-Vorlage.
as24ci_ai_gen_alt_text, as24ci_ai_gen_seo, as24ci_ai_extract_highlightsZusätzliche Schalter für die automatische Generierung.

Probefahrt-Buchung (optional)

Option-KeyZweck
as24ci_test_drive_enabledHauptschalter.
as24ci_test_drive_available_daysKommagetrennte Wochentagsnummern (0 = Sonntag).
as24ci_test_drive_start_time, as24ci_test_drive_end_timeTägliches Zeitfenster in HH:MM.
as24ci_test_drive_slot_durationSlot-Dauer in Minuten.
as24ci_test_drive_blackout_datesSerialisierte Liste von Sperrtagen.

Suchaufträge und Funktions-Schalter

Option-KeyZweck
as24ci_feature_search_agentSuchaufträge (Smart Stock Alerts) aktivieren.
as24ci_feature_compareVergleichs-Buttons und Vergleichsseite.
as24ci_feature_favoritesFavoriten/Wunschliste.
as24ci_feature_schemaSchema.org- und Open Graph-Metadaten auf Einzelseiten.
as24ci_feature_social_shareSocial-Sharing-Buttons.
as24ci_social_share_placementPlatzierung der Social-Sharing-Buttons auf der Einzelseite.
as24ci_social_share_networksAktive soziale Netzwerke für die Sharing-Buttons.
as24ci_feature_sitemapSitemap-Integration.
as24ci_feature_dashboard_widgetAdmin-Dashboard-Widget.
as24ci_feature_lazy_loadingLazy Loading für Bilder.
as24ci_feature_bulk_actionsMassenaktionen in der Fahrzeugliste.
as24ci_feature_exportCSV/JSON-Export aus den Werkzeugen.
as24ci_feature_pdf_datasheetPDF-Datenblatt-Download (Hauptschalter für den Frontend-Button „PDF herunterladen“).
as24ci_pdf_manager_settingsArray mit Branding-, Layout-, QR- und Inhaltseinstellungen für die PDF-Datenblatt-Ausgabe. Unabhängig von as24ci_feature_pdf_datasheet.

Analytics

Option-KeyZweck
as24ci_analytics_enabledHauptschalter für das Analytics-Tracking.
as24ci_analytics_bi_enabledErweiterte BI-Events (Filtersuchen, Kontakt-Öffnungen, Lead-Einsendungen).
as24ci_analytics_require_consentTracking blockieren, bis die Zustimmung des Besuchers erteilt wurde.
as24ci_analytics_filter_minimizationFreitext-Sucheingaben vor dem Speichern von Events bereinigen.
as24ci_analytics_retention_daysAufbewahrungszeitraum für die Analytics-Tabelle (Standard 180).
as24ci_analytics_privacy_jurisdictionDatenschutz-Label (auto, gdpr, dsgvo, revdsg, uk_gdpr, generic).

Vergleich und Finanzierung

Option-KeyZweck
as24ci_compare_max_vehiclesMaximale Anzahl gleichzeitig verglichener Fahrzeuge. Begrenzt zwischen 2 und 8.
as24ci_financing_enabledFinanzierungsrechner aktivieren.
as24ci_financing_default_rateStandard-Jahreszinssatz (%). Zulässiger Bereich 0–50.
as24ci_financing_default_monthsStandard-Kreditlaufzeit in Monaten (12, 24, 36, 48, 60, 72, 84).
as24ci_financing_down_paymentStandard-Anzahlung (%). Zulässiger Bereich 0–100.
as24ci_financing_placementbelow_gallery, sidebar oder end_of_page.

Design und Layout

Das Plugin stellt eine Vielzahl von Designoptionen unter den Präfixen as24ci_design_*, as24ci_single_*, as24ci_archive_*, as24ci_fav_*, as24ci_comp_* und as24ci_badge_* bereit. Diese steuern Farben, Typografie, Abstände, das Erscheinungsbild von Badges und benutzerdefiniertes CSS. Die vollständige Liste finden Sie in den Konstanten in AS24CI\Options.

Das Layout auf Seitenebene verwendet dedizierte Keys:

Option-KeyZweck
as24ci_layout_manager_enabledHauptschalter für den Layout-Manager.
as24ci_lm_zone_*, as24ci_lm_block_*Konfiguration pro Zone und Block.
as24ci_layout_archive_columnsAnzahl der Spalten im Archiv-Raster (1–4, Standard 3).
as24ci_archive_default_sortStandard-Sortierreihenfolge im Archiv (date_desc, price_asc, price_desc, mileage_asc).
as24ci_archive_per_pageAngezeigte Fahrzeuge pro Seite im Archiv (Standard 24).
as24ci_archive_list_excerpt_lengthMaximale Zeichenanzahl für den Auszug in der Listenansicht (0–500, Standard 75; 0 blendet den Auszug aus).
as24ci_layout_search_filtersAktive Filterblöcke in der Suchfilter-Zone.
as24ci_layout_single_main, as24ci_layout_single_sidebar, as24ci_layout_single_bottomAufbau der Fahrzeug-Einzelseite.

Filter und Feldsichtbarkeit

Option-KeyZweck
as24ci_filters_enabledArray der aktivierten Filter-Keys für das öffentliche Archiv (null bedeutet alle aktiviert).
as24ci_field_visibilitySichtbarkeits-Map pro Ansicht für car_details, sidebar, compare und favorites.
as24ci_mapping_overridesFeldbezeichnungs- und Sichtbarkeits-Überschreibungen für importierte AS24-Felder (serialisierte labels / visible Maps).

Hub-API und Standorte

Option-KeyZweck
as24ci_hub_api_keyAPI-Key für die Hub- / Market Insights-Integration. Sensibel.
as24ci_hub_target_marketZielmarkt-Code, der von der Hub-Integration verwendet wird.
as24ci_locationsSerialisierte Liste der Autohaus-Standorte (Name, Adresse, Seller-IDs, Öffnungszeiten). Autoload aus.

CMH Team

Option-KeyZweck
as24ci_team_membersSerialisierte Liste der vom Plugin verwalteten Autohaus-Teammitglieder (Verlaufskontakte). Autoload aus.
as24ci_team_location_defaultsZuordnung von AutoScout24 Seller-ID → Standard-Teammitglied-ID (Standardkontakt auf Standortebene). Autoload aus.
as24ci_team_standardsGlobale Fallback- / allgemeine Autohaus-Kontakteinstellungen (globale Standard-Mitglieds-ID und allgemeine Kontaktdaten). Autoload aus.
as24ci_team_rulesFlags für das automatische Zuweisungsverhalten für CMH Team. Autoload aus.

Datenqualitätsüberwachung

Option-KeyZweck
as24ci_dq_scan_enabledHauptschalter.
as24ci_dq_scan_frequencydaily oder twicedaily.
as24ci_dq_scan_timeErstlaufzeit in HH:00 (WordPress Website-Zeitzone).
as24ci_last_term_hash, as24ci_taxonomy_anomaliesInterner Scan-Status.

Autohaus-Profil

Wird vom Einrichtungsassistenten erfasst und vom PDF-Datenblatt, den Kontaktboxen, strukturierten Daten und Standorten wiederverwendet. Gespeichert als einfache Optionen auf oberster Ebene.

Option-KeyZweck
as24ci_dealer_nameName des Autohauses.
as24ci_dealer_streetStraße und Hausnummer.
as24ci_dealer_postal_codePostleitzahl.
as24ci_dealer_cityOrt.
as24ci_dealer_countryLand.
as24ci_dealer_phoneTelefonnummer.
as24ci_dealer_emailKontakt-E-Mail.
as24ci_dealer_websiteWebsite-URL.
as24ci_dealer_logo_idAnhangs-ID des Autohaus-Logos.
as24ci_dealer_languageBevorzugte Frontend-Sprache (site_default oder ein Gebietsschema wie de_DE).

Setup-Assistent

OptionsschlüsselZweck
as24ci_setup_wizard_completed1, sobald der Setup-Assistent abgeschlossen wurde.
as24ci_setup_wizard_skipped1, wenn der Setup-Assistent übersprungen wurde.
as24ci_setup_modeAusgewählter Setup-Modus.
as24ci_setup_completed_atZeitstempel, an dem das Setup abgeschlossen wurde.
as24ci_setup_completed_byBenutzer-ID, die das Setup abgeschlossen hat.
as24ci_setup_first_activation_atZeitstempel der ersten Plugin-Aktivierung.

EnVKV (Deutsche Energieverbrauchskennzeichnung)

OptionsschlüsselZweck
as24ci_envkv_yearReferenzjahr für die EnVKV-Kostenberechnung.
as24ci_envkv_price_petrol, as24ci_envkv_price_diesel, as24ci_envkv_price_electricEnergiepreise pro Kraftstoffart.
as24ci_envkv_co2_price_low, as24ci_envkv_co2_price_med, as24ci_envkv_co2_price_highCO₂-Preisstufen.
as24ci_envkv_show_costs_100kmGeschätzte Kosten pro 100 km anzeigen.

Content Studio (optional)

Content Studio ist ein abgegrenztes Modul mit eigenen Optionsschlüsseln (Konstanten in includes/class-as24ci-content-studio-options.php, AS24CI\Content_Studio_Options).

OptionsschlüsselZweck
as24ci_content_studio_db_versionSchema-Version für die benutzerdefinierten Tabellen von Content Studio.
as24ci_content_studio_google_api_keyKundeneigener Google-API-Schlüssel, der vom Content Studio-Text-Client verwendet wird. Sensibel.
as24ci_content_studio_default_languageStandard-Ausgabesprache für generierte Copy Packages.
as24ci_content_studio_default_toneStandard-Tonalität für generierte Copy Packages.
as24ci_content_studio_brand_voiceOptionaler Stil-Hinweis für die Markenstimme des Autohauses (max. 800 Zeichen).
as24ci_content_studio_disclaimer_textOptionaler, obligatorischer Disclaimer-Text für generierte Texte (max. 500 Zeichen).
as24ci_content_studio_compliance_notesOptionale Compliance-Hinweise für generierte Texte (max. 1000 Zeichen).

Lizenzaktivierung

Das Plugin aktiviert und validiert seine Lizenz erneut gegenüber der ADP Car Market Hub API Platform. Nur der Lizenzschlüssel und das Refresh-Signal-Secret sind Geheimnisse (verschlüsselt im Ruhezustand über AS24CI\Secrets gespeichert); jeder andere Schlüssel enthält einen nicht-geheimen Lizenzstatus, der zur Steuerung operativer Schreibfunktionen verwendet wird.

OptionsschlüsselZweck
as24ci_license_keyVerschlüsselter API Platform-Lizenzschlüssel (Secrets-Umschlag). Sensibel.
as24ci_license_statusOperativer Lizenzstatus (License_Manager::STATUS_*).
as24ci_license_last_checked_atUnix-Zeitstempel der letzten erfolgreichen Antwort der API Platform (0 = nie).
as24ci_license_last_errorLetzter Lizenzfehler, nur als stabiler Code.
as24ci_license_prefixSicherer, nicht-geheimer Lizenzschlüssel-Präfix, der von der API Platform zurückgegeben wird.
as24ci_license_planLabel des Lizenztarifs.
as24ci_license_support_untilISO-Zeitstempel, bis zu dem Support enthalten ist (informativ).
as24ci_license_expires_atISO-Zeitstempel, an dem die Lizenz abläuft (informativ).
as24ci_license_installation_uidInstallations-UID, die von der API Platform bei der Aktivierung ausgestellt wurde.
as24ci_license_manifestNicht-geheimes Manifest-Objekt, das von der API Platform zurückgegeben wird.
as24ci_license_feature_rightsVon der API Platform zurückgegebene Feature-Rechte-Map.
as24ci_license_import_policyVon der API Platform zurückgegebenes Import-Policy-Objekt.
as24ci_license_normalized_domainNormalisierte Domain, für die die Lizenz zuletzt aktiviert/validiert wurde.
as24ci_license_last_reported_versionPlugin-Version, die zuletzt als an die API Platform gemeldet bestätigt wurde.
as24ci_license_refresh_signal_secretVerschlüsseltes, pro Installation geteiltes Geheimnis zur Authentifizierung eingehender Lizenz-Aktualisierungssignale. Sensibel.

Verwaltete KI-Zugangsdaten (API Platform-Synchronisierung)

Die Google Gemini-Zugangsdaten des Kunden werden Server-zu-Server von der API Platform bereitgestellt und von AS24CI\Ai_Credential_Manager verwaltet. Der Gemini-Schlüssel wird nur in einem verschlüsselten Umschlag gespeichert; alle anderen Zeilen enthalten sichere Metadaten für die Admin-Statuskarte.

OptionsschlüsselZweck
as24ci_ai_credential_envelopeVerschlüsselter Gemini-Zugangsdaten-Umschlag. Wird nie automatisch geladen, nie gerendert. Sensibel.
as24ci_ai_credential_providerRoher Provider-Wert, der von der API Platform zurückgegeben wird (z. B. google / gemini).
as24ci_ai_credential_display_providerFür den Kunden sichtbares Provider-Label (immer "Google Gemini").
as24ci_ai_credential_api_modelModell, genau wie von der API Platform gemeldet.
as24ci_ai_credential_effective_modelEffektives Gemini-Laufzeitmodell nach Validierung/Fallback.
as24ci_ai_credential_fingerprintNicht-geheimer Fingerabdruck der bereitgestellten Zugangsdaten (Rotationsmarker).
as24ci_ai_credential_synced_atUnix-Zeitstempel der letzten erfolgreichen Synchronisierung der Zugangsdaten.
as24ci_ai_credential_checked_atUnix-Zeitstempel des letzten Synchronisierungsversuchs.
as24ci_ai_credential_statusLokaler KI-Verfügbarkeitsstatus-String.
as24ci_ai_credential_last_errorLetzter nicht-sensibler Synchronisierungsfehler/Entscheidungsgrund-Code.
as24ci_ai_usage_reporting_requiredOb die API Platform eine Berichterstattung über die KI-Nutzung erfordert.

Updates und Update-Sichtbarkeit

Sichere, nicht-geheime Buchführung für den privaten Update-Flow. Keine dieser Zeilen wird automatisch geladen, und keine speichert eine signierte Paket-URL, eine Signatur, ein Geheimnis oder einen Lizenzschlüssel.

OptionsschlüsselZweck
as24ci_update_last_check_diagDiagnose der letzten privaten Update-Prüfung (nur nicht-geheime Metadaten).
as24ci_update_visibility_last_refresh_atUnix-Zeitstempel des letzten Versuchs zur Aktualisierung der Sichtbarkeit.
as24ci_update_visibility_last_refresh_reasonStabiler Ursachencode für die letzte Aktualisierungsentscheidung.
as24ci_update_visibility_last_refresh_resultErgebnis des letzten Aktualisierungsversuchs (refreshed oder skipped).
as24ci_update_visibility_last_skip_reasonStabiler Ursachencode für die letzte übersprungene Aktualisierung.
as24ci_update_visibility_last_inconsistency_refresh_atZeitstempel der letzten Aktualisierung, die ausgelöst wurde, um einen inkonsistenten transienten Zustand zu beheben.
as24ci_update_last_transient_snapshotKleiner, sicherer Snapshot des Transienten update_plugins für dieses Plugin.

Schema- und Migrationsverfolgung

OptionsschlüsselZweck
as24ci_db_versionGesamte Plugin-Datenversion.
as24ci_caps_versionMigrationsversion für Berechtigungen/Rollen.
as24ci_vehicles_db_version, as24ci_search_agent_db_version, as24ci_analytics_db_versionSchema-Versionen pro Tabelle.

Bearbeiten Sie diese nicht manuell, es sei denn, Sie möchten eine erneute Migration erzwingen.

Operative Hinweise

  • Sensible Werte. Behandeln Sie as24ci_client_secret, as24ci_cron_token, as24ci_webhook_secret, as24ci_hub_api_key und as24ci_content_studio_google_api_key als Zugangsdaten. Übertragen Sie diese nicht in die Versionsverwaltung und geben Sie sie nicht in Templates oder Logs aus. Die im Ruhezustand verschlüsselten Optionen as24ci_license_key, as24ci_license_refresh_signal_secret und as24ci_ai_credential_envelope werden über AS24CI\Secrets gespeichert. Der zur Laufzeit bereitgestellte, verwaltete Gemini-Schlüssel gehört AD Promotion in AS24CI\Ai_Config und wird nicht als Klartext-Option WordPress gespeichert.
  • Boolean-Codierung. Die meisten Boolean-Schalter werden als die Strings '1' und '0' gespeichert. Vergleichen Sie mit Strings oder casten Sie über (string) vor dem Vergleich.
  • Filtern zur Laufzeit. Standardmäßige WordPress-Filter (option_<key>, pre_option_<key>, default_option_<key>) funktionieren für jede Option hier. Dies ist der empfohlene Weg, um Werte zur Bereitstellungszeit zu überschreiben, ohne in die Datenbank zu schreiben.
  • Multisite. Alle oben genannten Schlüssel gelten pro Website. Richten Sie diese auf jeder Website einzeln ein, es sei denn, Sie haben eine netzwerkweite Automatisierung implementiert.
  • Standardwerte. Standardwerte werden im Code angewendet. Die genauen Standardwerte können sich zwischen den Versionen ändern; überprüfen Sie diese vor der Veröffentlichung anhand des aktuellen Quellcodes.

Verwandte Dokumente