Dokumentation · Admin-Referenz
Mapping-Referenz
Dieses Dokument ist eine Referenz für den Mapping-Bildschirm des ADP Car Market Hub-Plugins (Car Market Hub → Mapping). Es erklärt, wie eingehende AutoScout24-Felder in WordPress zugeordnet 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 im Frontend angezeigtes Feld umbenennen, ein Feld ausblenden möchten, das Besuchern nicht angezeigt werden soll, oder die Zuordnung zwischen den AutoScout24-Quellfeldern und den vom Plugin verwendeten WordPress-Meta-Keys überprüfen möchten.
Übersicht
Jedes aus AutoScout24 importierte Fahrzeug wird als as24ci_car-Beitrag in WordPress gespeichert, wobei die Quellfelder in dedizierte Post-Meta-Keys geschrieben werden. Der Mapping-Bildschirm stellt diese Zuordnung 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 einsehen.
- Das Label (die Beschriftung) anpassen, das Templates für dieses Feld verwenden.
- Den Status Sichtbar umschalten, um das Feld 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 Export & 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 in 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 Car Market Hub → Mapping.
- Tippen Sie optional in das Feld Felder durchsuchen, um Zeilen über alle Gruppen hinweg nach Feldname, Label oder Meta-Key zu filtern. Während der Eingabe 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 sofort beim nächsten Laden der Frontend-Seite wirksam.
Ausstattungs- / Merkmals-Codes anpassen
- Scrollen Sie zur Karte Ausstattung & Merkmale.
- Bearbeiten Sie die Spalte Label für jeden Merkmals-Code, den Sie unter einem anderen Namen anzeigen möchten.
- Schalten Sie Sichtbar für alle Merkmals-Codes aus, die nicht angezeigt werden sollen.
- Klicken Sie auf Mapping-Einstellungen speichern.
Aktuelles Mapping exportieren
- Öffnen Sie die Karte Export & Zurücksetzen.
- Klicken Sie auf JSON exportieren oder CSV exportieren, um eine Momentaufnahme der aktuellen Mapping-Konfiguration einschließlich der Label- und Sichtbarkeitsüberschreibungen herunterzuladen.
Alle Überschreibungen zurücksetzen
- Öffnen Sie die Karte Export & 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, Händler-Referenzen, Zeitstempel und Status-Flags des Inserats.
- Fahrzeugbasis / Typ – Marke, Modell, Versions-Identifikatoren, Zertifizierungsdetails, Fahrzeugkategorie.
- Karosserie & Abmessungen – Karosserieform, Außen- und Innenfarbe, Sitzplätze, Anzahl der Türen, physische Abmessungen einschließlich Kofferraumvolumen.
- Motor & Antrieb – Kraftstoffart, Antriebssystem, Getriebe, Hubraum, Zylinderkonfiguration, Leistungsdaten.
- Verbrauch, Emissionen & Energie – Kraftstoff- und Gasverbrauch (innerorts / außerorts / kombiniert), CO₂-Emissionen, Emissionsklasse, Energielabel.
- Elektrifizierung & Laden – Batteriekapazität, Batteriezustand (SOH), Mietpreis, elektrische Reichweite, AC/DC-Ladesteckertypen, Nennleistungen, Ladezeiten.
- Kilometerstand & Zulassung – Fahrzeugzustand, Erstzulassungsdatum, Kilometerstand, Inspektionsstatus.
- Gewicht, Anhängelast & Nutzlast – Leergewicht, zulässiges Gesamtgewicht, Nutzlast, gebremste Anhängelast.
- Preis & Garantie – Verkaufspreis, unverbindliche Preisempfehlung 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. |
Export & Zurücksetzen
| Aktion | Hinweise |
|---|---|
| JSON exportieren | Gibt eine JSON-Datei aus, die die gespeicherten Überschreibungen enthält. |
| CSV exportieren | Gibt eine CSV-Datei mit denselben Daten aus. |
| Auf Standardwerte zurücksetzen | Entfernt die gesamte Option für Überschreibungen; jedes Feld fällt auf seinen integrierten Standardwert zurück. |
Betriebshinweise
- Alle Überschreibungen werden in einer einzigen WordPress-Option gespeichert, nicht in den Metadaten einzelner Beiträge. Dies bedeutet, dass Änderungen sofort für alle importierten Fahrzeuge wirksam werden, ohne dass Daten neu importiert werden müssen.
- Das Speichern des Formulars speichert den Sichtbarkeitsstatus für jedes bekannte Feld. Alles, was im Formular nicht vorhanden ist, wird standardmäßig als sichtbar behandelt.
- Feld-Labels sind bereit für die Übersetzung. Wenn Ihre Website in einer anderen Sprache als Englisch betrieben wird, 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. Informationen zum Ändern der heruntergeladenen Bilder oder Daten finden Sie in der Referenz für Import und Limits.
- Das Ausblenden eines Feldes an dieser Stelle wirkt sich auch auf die im Layout-Manager pro Zone konfigurierte Feldsichtbarkeit aus, da beide Ebenen ein Feld zulassen müssen, damit es gerendert wird.
Fehlerbehebung
- Eine Label-Änderung wird nicht angezeigt. Vergewissern Sie sich, dass Sie auf 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 entsprechende 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-Streamphp://output; einige restriktive Hosts blockieren diesen möglicherweise. Überprüfen Sie dies in der aktuellen Plugin-Version vor der Veröffentlichung. - Auf Standardwerte zurücksetzen 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 Merkmals-Code ist unter Ausstattung & Merkmale ausgeblendet. Überprüfen Sie den Schalter „Sichtbar“ erneut und importieren Sie das Fahrzeug bei Bedarf neu (siehe Fahrzeug-Importer Referenz).