Settings Reference

Dieses Dokument ist eine Referenz für die Seite Settings (Einstellungen) des ADP Car Market Hub-Plugins (Car Market Hub → Settings). Es erklärt jede Karte auf der Seite, was die einzelnen Felder steuern und wie die Werte validiert und gespeichert werden.

Wann Sie dieses Dokument verwenden sollten

Verwenden Sie diese Referenz, wenn Sie das Plugin zum ersten Mal konfigurieren, wenn Sie nachschlagen müssen, was eine bestimmte Option bewirkt, oder wenn Sie Fehler bei einem Verhalten beheben, das von einer Einstellung abhängt.

Übersicht

Die Einstellungsseite ist als vertikaler Stapel von Karten organisiert. Jede Karte hat ihre eigene Schaltfläche Save Settings (Einstellungen speichern), aber das Absenden einer beliebigen Schaltfläche speichert die gesamte Seite. Die Seite ist in folgende Abschnitte unterteilt:

1. License and Activation (oben auf der Seite angezeigt)
2. API Connection & General Settings
3. Default Pages & Shortcodes
4. SEO & Integrations
5. Frontend Features
6. Admin Features
7. Danger Zone

Anforderungen oder Voraussetzungen

• Zugriff auf Car Market Hub → Settings (erfordert die Verwaltungsberechtigung des Plugins).
• Für die API-Verbindung: Gültige Zugangsdaten, die von Ihrem Datenanbieter (AutoScout24 oder einem kompatiblen Integrations-Endpunkt) ausgestellt wurden. Diese werden nicht vom Plugin bereitgestellt und müssen separat erworben werden.
• Für Standardseiten: Berechtigung zum Erstellen von WordPress-Seiten.

Schritt-für-Schritt-Anleitung

1. Öffnen Sie Car Market Hub → Settings.
2. Füllen Sie die Karte API Connection & General Settings mit der URL, der Seller ID und den von Ihrem Anbieter bereitgestellten Zugangsdaten aus und wählen Sie dann die Standardwährung.
3. Speichern Sie und vergewissern Sie sich, dass am oberen Bildschirmrand keine Validierungsfehler angezeigt werden.
4. Aktivieren Sie optional Create default pages on save, damit das Plugin die Seiten für Fahrzeuge, Vergleich und Favoriten automatisch erstellt. Andernfalls betten Sie die entsprechenden Shortcodes manuell auf den Seiten Ihrer Wahl ein.
5. Überprüfen Sie die Karten SEO & Integrations, Frontend Features und Admin Features und aktivieren Sie die Funktionen, die Sie benötigen.
6. Aktivieren Sie Elemente in der Danger Zone erst, nachdem Sie die Warnungen sorgfältig gelesen und gegebenenfalls ein Backup erstellt haben.

Konfigurationsreferenz

License and Activation

Die Karte License ist die erste Karte auf der Einstellungsseite. ADP Car Market Hub ist ein lizenziertes Produkt: Die Lizenz schaltet die Premium-Bereiche (wie AI Assistant, Content Studio und Market Insights) frei und ermöglicht Updates und Support. Der Lizenzschlüssel wird von AD Promotion bereitgestellt.

Wie die Lizenzierung funktioniert, Schritt für Schritt:

1. Aktivieren Sie die Lizenz. Fügen Sie den von AD Promotion bereitgestellten Schlüssel in das Feld License key ein und klicken Sie auf Activate. Das Plugin kontaktiert den Lizenzierungsdienst, validiert den Schlüssel für die Domain dieser Website und speichert ihn maskiert. Wenn Sie jemals einen Schlüssel erneut eingeben, lautet die Schaltfläche Re-activate.
2. Überprüfen Sie den Status jederzeit. Klicken Sie auf Check license now, um den aktuellen Status beim Lizenzierungsdienst abzufragen. Die Karte aktualisiert dann den Status (z. B. Active, Inactive, Suspended oder Expired), den Tarif, die Ablauf-/Supportdaten und die enthaltenen Funktionen. Derselbe Lizenzstatus wird auch als KPI-Kachel auf dem Dashboard und dem Support-Bildschirm angezeigt, sodass Sie ihn sehen können, ohne die Einstellungen zu öffnen.
3. Sehen Sie, welche Funktionen freigeschaltet sind. Wenn die Lizenz aktiv ist, zeigt die Karte eine Zeile Included features an, in der die Premium-Bereiche aufgeführt sind, die Ihre Lizenz abdeckt (z. B. AI Assistant, Content Studio, Market Insights). Jeder Premium-Bildschirm spiegelt dies ebenfalls direkt wider: Wenn ein Bereich enthalten ist, zeigt er seine normalen Steuerelemente an, und wenn er nicht enthalten ist, zeigt er stattdessen eine Karte "not included in this license" an.
4. Erneut aktivieren oder entfernen. Verwenden Sie Re-activate nach einer Tarifänderung, um die neuen Berechtigungen abzurufen, oder Remove license, um den gespeicherten Schlüssel von dieser Website zu löschen (Premium-Bereiche werden dann wieder gesperrt).

Das meiste davon läuft automatisch im Hintergrund: Das Plugin überprüft die Lizenz regelmässig und hält den Status aktuell. Die manuelle Funktion Check license now dient daher hauptsächlich dazu, eine Änderung sofort zu bestätigen.

Wenn ein Schlüssel aktiv ist, zeigt die Karte auch schreibgeschützte Details an: Plan, Expires, Support until, Domain, Last checked, Reported version, das Importlimit und die Liste der Included features. Derselbe Lizenzstatus wird auch als KPI auf dem Dashboard und dem Support-Bildschirm angezeigt.

Premium-Bereiche, die nicht Teil Ihrer Lizenz sind, zeigen auf ihrer eigenen Seite anstelle der normalen Steuerelemente eine Karte "not included in this license" an (siehe AI Assistant-Referenz, Content Studio-Referenz und Referenz zu Market Insights). In diesem Zustand ist nichts kaputt – kontaktieren Sie den Support von ADP Car Market Hub, um den Bereich freizuschalten.

API Connection & General Settings

Wenn sich die Zugangsdaten ändern, löscht das Plugin seinen zwischengespeicherten Access Token und den zwischengespeicherten API-Verbindungsstatus, sodass der nächste Seitenaufruf die neue Konfiguration widerspiegelt.

Default Pages & Shortcodes

Die Karte listet auch kopierfertige Shortcodes auf:

• [as24ci_archive] – Fahrzeugliste.
• [as24ci_compare] – Vergleichsseite.
• [as24ci_favorites] – Favoriten- / Merkzettelseite.
• [as24ci_archive make="BMW" price_max="40000" order_by="price" order="asc"] – Beispiel für eine vorgefilterte Liste.

Unterstützte [as24ci_archive]-Parameter wie im Admin dokumentiert: make, model, price_min, price_max, fuel, body, order_by (price / mileage / date), order (asc / desc), per_page (12 / 24 / 48 / 72 / all).

SEO & Integrations

Frontend Features

Die Finanzierungswerte sind Standardwerte, die im Rechner im Frontend vorausgefüllt sind; Besucher können sie anpassen, wenn das Rechner-Template dies zulässt.

Admin Features

Danger Zone

Betriebliche Hinweise

• Jede Karte hat ihre eigene Schaltfläche zum Absenden, aber jedes Absenden sendet das gesamte Formular. Das Speichern einer beliebigen Karte speichert jedes Feld auf der Seite.
• API-Zugangsdaten werden in der WordPress-Optionstabelle gespeichert. Jeder mit Datenbank- oder Admin-Exportzugriff kann sie lesen; schützen Sie die Website entsprechend.
• Das Aktivieren des Finanzierungsrechners platziert ihn nicht von selbst auf der Seite – die Platzierung wird im Layout Manager gesteuert.
• Der REST-API-Umschalter steuert nur die öffentlichen Fahrzeug-Endpunkte. Interne Admin-AJAX-Endpunkte, die vom Plugin verwendet werden, sind von diesem Umschalter nicht betroffen.
• Die Aktion "Create default pages on save" wird nur ausgeführt, wenn das Kontrollkästchen im Moment des Speicherns aktiviert ist. Wenn Sie es später deaktivieren, werden zuvor erstellte Seiten nicht gelöscht.

Fehlerbehebung

• Fehler "The API Base URL is not a valid URL". Der Wert hat FILTER_VALIDATE_URL nicht bestanden. Geben Sie die vollständige URL einschliesslich des Schemas (https://) und ohne zusätzliche Zeichen ein. Der vorherige Wert wird beibehalten, bis eine gültige URL angegeben wird.
• Importe liefern nach dem Speichern der Zugangsdaten 401 / 403-Fehler. Überprüfen Sie Client ID, Client Secret und Seller ID bei Ihrem Anbieter. Der Token-Cache wird beim Speichern gelöscht, sodass die nächste Anfrage die neuen Werte verwendet.
• Standardseiten wurden nicht erstellt. Der Umschalter wirkt nur beim Speichern. Stellen Sie sicher, dass der Umschalter aktiviert ist, wenn Sie auf Speichern klicken, und dass der WordPress-Benutzer die Berechtigung zum Erstellen von Seiten hat.
• Währung ändert sich im Frontend nicht. Das Feld speichert einen Standardwert. Währungen pro Fahrzeug, die vom Datenanbieter stammen, können die Anzeige je nach den aktiven Templates überschreiben. Überprüfen Sie dieses Verhalten in der aktuellen Plugin-Version vor der Veröffentlichung.
• Finanzierungsrechner ist aktiviert, aber nicht sichtbar. Fügen Sie den Block "Finanzierungsrechner" einer der Single Vehicle-Zonen im Layout Manager hinzu. Der Einstellungsbildschirm warnt nicht vor der Platzierung; er zeigt nur eine statische Beschreibung, die auf den Layout Manager verweist. Um zu vermeiden, dass der Rechner doppelt erscheint, stellen Sie sicher, dass er nur einer Single Vehicle-Zone hinzugefügt wird.

Verwandte Dokumente

• Admin-Menü-Übersicht
• Referenz zum Fahrzeug-Importer
• Referenz zu Import & Limits
• Layout Manager-Referenz
• Shortcodes And Widgets Reference