Dokumentation · Admin-Referenz

Mapping-Referenz

Dieses Dokument ist eine Referenz für den Mapping-Bildschirm des ADP Car Market Hub-Plugins (CMH Center → Mapping). Es erklärt, wie eingehende AutoScout24-Felder in WordPress gemappt werden, was Sie pro Feld anpassen können und wie Sie die Konfiguration exportieren oder zurücksetzen.

Wann Sie dieses Dokument verwenden sollten

Lesen Sie dieses Dokument, wenn Sie ein Feld, das im Frontend angezeigt wird, umbenennen möchten, ein Feld ausblenden möchten, das für Besucher nicht sichtbar sein soll, oder das Mapping zwischen den AutoScout24-Quellfeldern und den von den Plugin-Templates verwendeten WordPress-Meta-Keys überprüfen möchten.

Übersicht

Jedes aus AutoScout24 importierte Fahrzeug wird als as24ci_car-Post in WordPress gespeichert, wobei die Quellfelder in dedizierte Post-Meta-Keys geschrieben werden. Der Mapping-Bildschirm stellt dieses Mapping als eine Reihe von gruppierten Tabellen dar. Für jedes Feld können Sie:

Den ursprünglichen AS24-Feldnamen und den zugrunde liegenden WordPress-Meta-Key sehen.
Das Label anpassen, das von den Templates für dieses Feld verwendet wird.
Den Status Sichtbar des Feldes umschalten, um es im Frontend auszublenden.

Eine separate Karte Ausstattung & Merkmale listet jeden unterstützten Ausstattungscode auf (gespeichert als serialisiertes Array in einem einzigen Meta-Key) mit denselben Steuerelementen für Label und Sichtbarkeit. Eine Karte Exportieren & Zurücksetzen ermöglicht es Ihnen, die Konfiguration als JSON oder CSV zu sichern oder alle Überschreibungen auf die Plugin-Standardwerte zurückzusetzen.

Anforderungen oder Voraussetzungen

Berechtigung zur Verwaltung des Plugins (dieselbe Berechtigung, die auch an anderer Stelle im Car Market Hub verwendet wird).
Mindestens ein importiertes Fahrzeug, damit Änderungen an Labels und Sichtbarkeit im Frontend sichtbar sind.

Schritt-für-Schritt-Anleitung

Feld-Label anpassen oder ein Feld ausblenden

Öffnen Sie CMH Center → Mapping.
Tippen Sie optional in das Feld Felder suchen, um Zeilen über alle Gruppen hinweg nach Feldname, Label oder Meta-Key zu filtern. Während Sie tippen, zeigt die Suchleiste eine Live-Anzahl (N Treffer) der übereinstimmenden Zeilen an.
Bearbeiten Sie in der entsprechenden Gruppentabelle die Spalte Label für das Feld, das Sie umbenennen möchten. Leere Werte fallen auf das übersetzte Standard-Label zurück.
Verwenden Sie den Schalter Sichtbar, um das Feld in den Frontend-Templates auszublenden.
Klicken Sie unten im Abschnitt auf Mapping-Einstellungen speichern. Die Änderungen werden beim nächsten Laden der Frontend-Seite sofort wirksam.

Ausstattungs- / Merkmals-Codes anpassen

Scrollen Sie zur Karte Ausstattung & Merkmale.
Bearbeiten Sie die Spalte Label für jeden Merkmalscode, den Sie unter einem anderen Namen anzeigen möchten.
Schalten Sie Sichtbar für alle Merkmalscodes aus, die nicht angezeigt werden sollen.
Klicken Sie auf Mapping-Einstellungen speichern.

Aktuelles Mapping exportieren

Öffnen Sie die Karte Exportieren & Zurücksetzen.
Klicken Sie auf JSON exportieren oder CSV exportieren, um einen Snapshot der aktuellen Mapping-Konfiguration einschliesslich der Label- und Sichtbarkeitsüberschreibungen herunterzuladen.

Alle Überschreibungen zurücksetzen

Öffnen Sie die Karte Exportieren & Zurücksetzen.
Klicken Sie auf Auf Standardwerte zurücksetzen. Alle benutzerdefinierten Labels und Sichtbarkeitsüberschreibungen werden entfernt; jedes Feld kehrt zu seinem integrierten Standard-Label und Sichtbarkeitsstatus zurück.

Konfigurationsreferenz

Feldgruppen

Die Standard-Feldkarte ist in die folgenden logischen Gruppen unterteilt (jede Gruppe listet die darin enthaltenen AS24-Felder und eine kurze Beschreibung auf):

Identifikation & Status – Kern-Identifikatoren, Garagen-Referenzen, Zeitstempel und Status-Flags des Inserats.
Fahrzeugbasis / -typ – Marke, Modell, Versions-Identifikatoren, Zertifizierungsdetails, Fahrzeugkategorie.
Karosserie & Abmessungen – Karosserieform, Aussen- und Innenfarbe, Sitzplätze, Anzahl Türen, physische Abmessungen einschliesslich Kofferraummasse.
Motor & Antrieb – Kraftstoffart, Antriebssystem, Getriebe, Hubraum, Zylinderkonfiguration, Leistungsdaten.
Verbrauch, Emissionen & Energie – Kraftstoff- und Gasverbrauch (innerorts / ausserorts / kombiniert), CO₂-Emissionen, Emissionsklasse, Energieetikette.
Elektrifizierung & Laden – Batteriekapazität, Batteriezustand (SOH), Mietpreis, elektrische Reichweite, AC/DC-Ladesteckertypen, Nennleistungen, Ladezeiten.
Kilometerstand & Zulassung – Fahrzeugzustand, Datum der Erstzulassung, Kilometerzählerstand, Inspektionsstatus.
Gewicht, Anhängelast & Nutzlast – Leergewicht, zulässiges Gesamtgewicht, Nutzlastkapazität, gebremste Anhängelast.
Preis & Garantie – Verkaufspreis, Listenpreis des Herstellers, vollständige Garantiedetails (Typ, Dauer, Kilometerabdeckung).
Beschreibung & Medien – Teaser-Text des Inserats, vollständige Beschreibung, Bildergalerie-Felder.

Steuerelemente pro Feld

Spalte	Hinweise
AS24-Feld	Der ursprüngliche AutoScout24-Feldname (schreibgeschützt).
Label	Bearbeitbar. Leer = übersetztes Standard-Label. Maximale Länge: 120 Zeichen. Zeilen mit einer gespeicherten Label-Überschreibung zeigen ein Benutzerdefiniert-Badge.
WordPress-Meta-Key	Der Post-Meta-Key, unter dem der Wert gespeichert ist (schreibgeschützt).
Sichtbar	Umschalter. Deaktiviert bedeutet, dass Templates dieses Feld überspringen, selbst wenn das importierte Fahrzeug Daten dafür enthält.

Exportieren & Zurücksetzen

Aktion	Hinweise
JSON exportieren	Gibt eine JSON-Datei aus, welche die gespeicherten Überschreibungen enthält.
CSV exportieren	Gibt eine CSV-Datei mit denselben Daten aus.
Auf Standardwerte zurücksetzen	Entfernt die gesamte Überschreibungsoption; jedes Feld fällt auf seinen integrierten Standardwert zurück.

Betriebliche Hinweise

Alle Überschreibungen werden in einer einzigen WordPress-Option gespeichert, nicht in den einzelnen Post-Metadaten. Dies bedeutet, dass Änderungen sofort für alle importierten Fahrzeuge gelten, ohne dass die Daten neu importiert werden müssen.
Beim Speichern des Formulars wird der Sichtbarkeitsstatus für jedes bekannte Feld gespeichert. Alles, was im Formular nicht vorhanden ist, wird standardmässig als sichtbar behandelt.
Feld-Labels sind übersetzungsbereit. Wenn Ihre Website in einer anderen Sprache als Englisch läuft, zeigt die Spalte Label den übersetzten Standardwert an, bis Sie eine Überschreibung festlegen.
Der Mapping-Bildschirm ändert nicht, wie Daten importiert werden; er steuert nur, wie gespeicherte Daten beschriftet werden und ob sie im Frontend erscheinen. Um zu ändern, welche Bilder oder Daten heruntergeladen werden, lesen Sie die Referenz zu Import & Limits.
Das Ausblenden eines Feldes hier wirkt sich auch auf die Feldsichtbarkeit aus, die pro Zone im Layout Manager konfiguriert ist, da beide Ebenen ein Feld zulassen müssen, damit es gerendert wird.

Fehlerbehebung

Eine Label-Änderung wird nicht angezeigt. Vergewissern Sie sich, dass Sie in derselben Karte auf Mapping-Einstellungen speichern geklickt haben und dass der Frontend- oder CDN-Cache geleert wurde.
Ein Feld ist nach dem Aktivieren immer noch ausgeblendet. Überprüfen Sie den Layout Manager — der entsprechende Block oder die Zone muss das Feld ebenfalls enthalten.
Der Export-Download ist leer oder schlägt fehl. Stellen Sie sicher, dass kein anderes Plugin admin-post.php-Anfragen abfängt und dass der Benutzer über die Verwaltungsberechtigung verfügt. Der CSV-Pfad verwendet den php://output-Stream von PHP; einige restriktive Hosts blockieren diesen möglicherweise. Überprüfen Sie dies in der aktuellen Plugin-Version vor der Veröffentlichung.
Das Zurücksetzen auf die Standardeinstellungen hat nichts bewirkt. Das Zurücksetzen entfernt nur Überschreibungen. Wenn Labels immer noch angepasst erscheinen, haben Sie möglicherweise eine aktive Übersetzungsdatei, die das Standard-Label überschreibt.
Änderungen an Ausstattungs-Labels werden bei einem Fahrzeug nicht angezeigt. Dieses Fahrzeug wurde möglicherweise importiert, bevor das Ausstattungsfeld befüllt wurde, oder der Ausstattungscode ist unter Ausstattung & Merkmale ausgeblendet. Überprüfen Sie den Schalter "Sichtbar" erneut und importieren Sie das Fahrzeug bei Bedarf neu (siehe Referenz zum Fahrzeug-Importer).