Dokumentation · Admin-Referenz

Einstellungs-Referenz

Dieses Dokument ist eine Referenz für den Settings-Bildschirm 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 Fehler bei einem Verhalten beheben, das von einer Einstellung abhängt.

Übersicht

Der Settings-Bildschirm ist als vertikaler Stapel von Karten organisiert. Jede Karte hat ihre eigene Schaltfläche Save Settings, aber das Absenden einer dieser Schaltflächen speichert die gesamte Seite. Die Seite ist in die folgenden Abschnitte unterteilt:

Lizenz und Aktivierung (wird oben auf der Seite angezeigt)
Datenquellen & API-Verbindungen (ein Verweis auf die Connections-Seite)
Allgemeine Einstellungen (Standardwährung)
Standardseiten & Shortcodes
SEO & Integrationen
Frontend-Funktionen
Admin-Funktionen
Danger Zone

API-Zugangsdaten verschoben. Frühere Versionen haben 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. Der Settings-Bildschirm 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

Öffnen Sie CMH Center → Settings.
Wählen Sie die Standardwährung in der Karte General Settings. Um eine Datenquelle zu verbinden oder API-Zugangsdaten einzugeben, verwenden Sie die Schaltfläche Manage data sources (sie öffnet die Seite Connections).
Speichern Sie und vergewissern Sie sich, dass oben auf dem Bildschirm keine Validierungsfehler angezeigt werden.
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.
Überprüfen Sie die Karten SEO & Integrations, Frontend Features und Admin Features und aktivieren Sie die Funktionen, die Sie benötigen.
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 Karte Lizenz 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:

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.
Ü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 (z. B. Aktiv, Inaktiv, Sistiert 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.
Sehen Sie, welche Funktionen freigeschaltet sind. Wenn die Lizenz aktiv ist, zeigt die Karte eine Zeile Enthaltene Funktionen 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 "In dieser Lizenz nicht enthalten" an.
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).

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 Lizenz jetzt prüfen dient daher hauptsächlich dazu, eine Änderung sofort zu bestätigen.

Element	Hinweise
Lizenzschlüssel	Geben Sie den von AD Promotion bereitgestellten Schlüssel ein und klicken Sie auf Aktivieren (oder Reaktivieren). Der Schlüssel wird maskiert gespeichert und an die Domain dieser Website gebunden; der vollständige Schlüssel wird nie wieder angezeigt.
Status	Der aktuelle Lizenzstatus, zum Beispiel Aktiv, Inaktiv, Sistiert oder Abgelaufen.
Lizenz jetzt prüfen	Überprüft die Lizenz erneut beim Lizenzierungsdienst und aktualisiert den Status, den Tarif und die enthaltenen Funktionen. Verfügbar, sobald ein Schlüssel gespeichert ist.
Lizenz entfernen	Entfernt den gespeicherten Schlüssel von dieser Website. Premium-Funktionen, die von der Lizenz abhängen, werden wieder gesperrt.

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 angezeigt.

Premium-Bereiche, die nicht Teil Ihrer Lizenz sind, zeigen auf ihrer eigenen Seite eine Karte "In dieser Lizenz nicht enthalten" anstelle der normalen Steuerelemente an (siehe AI Assistant-Referenz, Content Studio-Referenz und Referenz zu Market Insights). In diesem Zustand ist nichts defekt – kontaktieren Sie 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 führt. 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. Geheimnisse wie das AutoScout24 Client Secret, das mobile.de API-Passwort und das carcuro-Token werden verschlüsselt auf dem Server gespeichert.

Allgemeine Einstellungen

Feld	Typ	Hinweise
Standardwährung	Auswahl	Wählen Sie einen der unterstützten ISO 4217-Codes: BGN, CHF, CZK, DKK, EUR, GBP, HUF, NOK, PLN, RON, RUB, SEK, TRY, UAH. Unbekannte Werte fallen auf EUR zurück.

Standardseiten & Shortcodes

Feld	Typ	Hinweise
Standardseiten beim Speichern erstellen	Umschalter	Wenn aktiviert und gespeichert, werden fehlende Seiten für Fahrzeuge, Fahrzeugvergleich und Favoriten erstellt. Bestehende Seiten werden nicht überschrieben.

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 & Integrationen

Feld	Standard	Hinweise
Schema.org & Open Graph	Ein	Gibt strukturierte JSON-LD-Daten und Open Graph / Twitter Card Meta-Tags auf Einzelfahrzeugseiten aus.
XML-Sitemap-Integration	Ein	Fügt Fahrzeug-Beiträge zu den WordPress-Core-Sitemaps mit korrekten `lastmod`-Daten hinzu. Das Admin-Label weist auf die Kompatibilität mit Yoast SEO und Rank Math hin.
Entfernte Fahrzeuge weiterleiten	Ein	Wenn die URL eines verkauften/entfernten Fahrzeugs einen 404-Fehler zurückgeben würde, wird eine 301-Weiterleitung zu einer vorgefilterten Suche nach derselben Marke und demselben Modell eingerichtet (abgestuft auf nur Marke, dann auf das Archiv, sodass der Benutzer nie auf einem leeren Ergebnis landet). Vermeidet Sackgassen-404-Fehler für indexierte/geteilte Links, ohne Weiterleitungsketten zu erzeugen.
REST-API	Aus	Wenn aktiviert, werden `GET /wp-json/as24ci/v1/vehicles` und `GET /wp-json/as24ci/v1/vehicles/{id}` für den externen Zugriff registriert.

Frontend-Funktionen

Feld	Standard	Hinweise
Favoriten / Merkzettel	Ein	Fügt Favoritensymbole im Archiv und in der schwebenden Seitenleiste auf Einzelseiten hinzu. Die Favoritenseite kann mit `[as24ci_favorites]` eingebettet werden. Die Implementierung basiert auf `localStorage`.
Fahrzeugvergleich	Ein	Fügt Vergleichs-Umschaltknöpfe im Archiv und auf Einzelseiten hinzu. Ausgewählte Fahrzeuge können über `[as24ci_compare]` angezeigt werden.
Finanzierungsrechner	Aus	Wenn aktiviert, kann der Rechner über den Layout Manager in "Einzelfahrzeug – Seitenleiste", "Einzelfahrzeug Hauptinhalt" oder "Einzelfahrzeug – Unterer Bereich" platziert werden.
Jährlicher Zinssatz (%)	3.9	Zulässiger Bereich 0–50, Schrittweite 0.1.
Kreditlaufzeit (Monate)	48	Zulässige Werte: 12, 24, 36, 48, 60, 72, 84.
Anzahlung (%)	20	Zulässiger Bereich 0–100.

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

Admin-Funktionen

Feld	Standard	Hinweise
Dashboard-Widget	Ein	Zeigt das Übersichts-Widget für Fahrzeugstatistiken auf dem WordPress-Dashboard an.
Massenaktionen	Ein	Fügt der Fahrzeug-Listentabelle die Massenaktionen "Auf Entwurf setzen", "Veröffentlichen" und "Mit Bildern löschen" hinzu.
Fahrzeugexport	Ein	Ermöglicht den CSV- / JSON-Export von Fahrzeugdaten auf der Registerkarte "Werkzeuge".

Danger Zone

Feld	Standard	Hinweise
Importierte Autos und importierte Bilder löschen, wenn das Plugin gelöscht wird	Aus	Wenn aktiviert, werden beim Deinstallieren des Plugins die Einträge des Custom Post Type "Cars" und deren importierte Anhänge entfernt. Vom Plugin erstellte Seiten werden nicht automatisch entfernt.

Operational notes

Jede Karte hat ihren eigenen Absenden-Button, aber jedes Absenden überträgt das gesamte Formular. Das Speichern einer beliebigen Karte sichert jedes Feld auf der Seite.
Die API-Zugangsdaten für die Datenquellen werden nicht hier eingegeben – diese befinden sich auf der Seite Connections. Geheimnisse dort (AutoScout24 Client Secret, mobile.de API-Passwort, carcuro Token, Feed-/Mailbox-Passwörter) werden 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 die zuvor erstellten Seiten nicht.

Troubleshooting

Wo gebe ich die API-Zugangsdaten ein? Nicht hier. Öffnen Sie die Seite Connections (oder nutzen Sie den Button 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 sowie 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 hat, Seiten zu erstellen.
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 Einzel-Fahrzeug-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 Einzel-Fahrzeug-Zone hinzugefügt wird.