Einstellungsreferenz

Dieses Dokument ist eine Referenz für die Seite Settings (Einstellungen) des ADP Car Market Hub-Plugins (CMH Center → Settings). Es erklärt jede Karte auf der Seite, was jedes Feld steuert 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 ein Verhalten beheben möchten, 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 dieser Schaltflächen speichert die gesamte Seite. Die Seite ist in folgende Abschnitte unterteilt:

1. Lizenz und Aktivierung (wird oben auf der Seite angezeigt)
2. Datenquellen & API-Verbindungen (ein Verweis auf die Verbindungsseite)
3. Allgemeine Einstellungen (Standardwährung)
4. Standardseiten & Shortcodes
5. SEO & Integrationen
6. Frontend-Funktionen
7. Admin-Funktionen
8. Gefahrenzone (Danger Zone)

API-Zugangsdaten verschoben. In früheren Versionen wurde die AutoScout24-API-Verbindung hier konfiguriert. Alle Zugangsdaten für Datenquellen (AutoScout24, mobile.de, carcuro, Feed, E-Mail) werden jetzt auf der Seite Connections eingegeben, wo jede Quelle auch ihren Verbindungsstatus anzeigt. Siehe Connections-Referenz. Die Einstellungsseite enthält nur noch allgemeine Optionen.

Anforderungen oder Voraussetzungen

• Zugriff auf CMH Center → Settings (erfordert die Verwaltungsberechtigung des Plugins).
• Für Zugangsdaten von Datenquellen: Verwenden Sie die Seite Connections, nicht diesen Bildschirm.
• Für Standardseiten: Berechtigung zum Erstellen von WordPress-Seiten.

Schritt-für-Schritt-Anleitung

1. Öffnen Sie CMH Center → Settings.
2. Wählen Sie die Standardwährung in der Karte General Settings aus. Um eine Datenquelle zu verbinden oder API-Zugangsdaten einzugeben, verwenden Sie die Schaltfläche Manage data sources (sie öffnet die Seite Connections).
3. Speichern Sie und bestätigen Sie, dass oben auf dem Bildschirm 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 benötigten Funktionen.
6. Aktivieren Sie Elemente in der Danger Zone erst, nachdem Sie die Warnhinweise sorgfältig gelesen und gegebenenfalls ein Backup erstellt haben.

---

Konfigurationsreferenz

Lizenz und Aktivierung

Die Lizenz-Karte 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.

So funktioniert die Lizenzierung Schritt für Schritt:

1. Aktivieren Sie die Lizenz. Fügen Sie den von AD Promotion bereitgestellten Schlüssel in das Feld Lizenzschlüssel ein und klicken Sie auf Aktivieren. 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 Beschriftung der Schaltfläche Reaktivieren.
2. Überprüfen Sie den Status jederzeit. Klicken Sie auf Lizenz jetzt prüfen, um den aktuellen Status beim Lizenzierungsdienst abzufragen. Die Karte aktualisiert dann den Status (zum Beispiel Aktiv, Inaktiv, Gesperrt oder Abgelaufen), 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 Enthaltene Funktionen an, in der die von Ihrer Lizenz abgedeckten Premium-Bereiche aufgelistet sind (zum Beispiel 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, wird stattdessen eine Karte "Nicht in dieser Lizenz enthalten" angezeigt.
4. Reaktivieren oder entfernen. Verwenden Sie Reaktivieren nach einer Tarifänderung, um die neuen Berechtigungen abzurufen, oder Lizenz entfernen, um den gespeicherten Schlüssel von dieser Website zu löschen (Premium-Bereiche werden dann wieder gesperrt).

Die meisten dieser Vorgänge laufen selbstständig im Hintergrund ab: Das Plugin überprüft die Lizenz regelmäßig und hält den Status aktuell. Die manuelle Funktion Lizenz jetzt prüfen 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: Tarif, Läuft ab, Support bis, Domain, Zuletzt geprüft, Gemeldete Version, das Importlimit und die Liste der Enthaltenen Funktionen. Derselbe Lizenzstatus wird auch als KPI auf dem Dashboard und dem Support-Bildschirm dargestellt.

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

Datenquellen & API-Verbindungen

Diese Karte enthält keine Felder. Es handelt sich um einen kurzen Hinweis, der erklärt, dass Datenquellen zentral konfiguriert werden, und eine Schaltfläche Datenquellen verwalten bereitstellt, die zur Seite Verbindungen verlinkt. Dort verbinden Sie AutoScout24, mobile.de, carcuro, einen automatischen Feed oder ein E-Mail-Postfach, geben die API-Zugangsdaten ein und sehen den Verbindungsstatus jeder Quelle. Sensible Daten wie das AutoScout24 Client Secret, das mobile.de API-Passwort und das carcuro-Token werden im Ruhezustand verschlüsselt gespeichert.

Allgemeine Einstellungen

Standardseiten & Shortcodes

Die Karte listet auch kopierfertige Shortcodes auf:

• [as24ci_archive] – Fahrzeugliste.
• [as24ci_compare] – Vergleichsseite.
• [as24ci_favorites] – Favoriten- / Wunschzettelseite.
• [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 & Integrationen

Frontend-Funktionen

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

Admin-Funktionen

Gefahrenzone

---

Betriebliche Hinweise

• Jede Karte hat ihre eigene Schaltfläche zum Absenden, aber jedes Absenden überträgt das gesamte Formular. Das Speichern einer beliebigen Karte speichert jedes Feld auf der Seite.
• Die API-Zugangsdaten der Datenquellen werden nicht hier eingegeben – sie befinden sich auf der Seite Connections. Geheimnisse dort (AutoScout24 Client Secret, mobile.de API-Passwort, carcuro-Token, Feed-/Postfach-Passwörter) werden im Ruhezustand verschlüsselt gespeichert.
• Das Aktivieren des Finanzierungsrechners platziert diesen nicht von selbst auf der Seite – die Platzierung wird im Layout-Manager gesteuert.
• Der REST-API-Schalter steuert nur die öffentlichen Fahrzeug-Endpunkte. Interne Admin-AJAX-Endpunkte, die vom Plugin verwendet werden, sind von diesem Schalter nicht betroffen.
• Die Aktion „Standardseiten beim Speichern erstellen“ wird nur ausgeführt, wenn das Kontrollkästchen im Moment des Speicherns aktiviert ist. Ein späteres Deaktivieren löscht zuvor erstellte Seiten nicht.

Fehlerbehebung

• Wo gebe ich die API-Zugangsdaten ein? Nicht hier. Öffnen Sie die Seite Connections (oder nutzen Sie die Schaltfläche Datenquellen verwalten), um AutoScout24, mobile.de, carcuro, einen Feed oder ein E-Mail-Postfach zu verbinden. Die Validierung der Zugangsdaten und 401/403-Fehler werden dort und unter API Connection Errors behandelt.
• Standardseiten wurden nicht erstellt. Der Schalter wirkt nur zum Zeitpunkt des Speicherns. Stellen Sie sicher, dass der Schalter 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. Fahrzeugspezifische Währungen, 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 Einzelbühnen-Zonen (Single Vehicle) im Layout Manager Reference 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 Einzelbühnen-Zone hinzugefügt wird.

Zugehörige Dokumente

• Übersicht über das Admin-Menü
• Connections Reference
• Fahrzeug-Importer Referenz
• Referenz für Import und Limits
• Referenz für Layout-Manager
• Shortcodes And Widgets Reference