Mapping-Referenz

Dieses Dokument ist eine Referenz für die Mapping-Seite des ADP Car Market Hub-Plugins (Car Market Hub → Mapping). Es erklärt, wie eingehende AutoScout24-Felder in WordPress zugewiesen 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 umbenennen möchten, das im Frontend angezeigt wird, ein Feld ausblenden möchten, das für Besucher unsichtbar sein soll, oder die Zuweisung zwischen den AutoScout24-Quellfeldern und den vom Plugin verwendeten WordPress-Metaschlüsseln ü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-Schlüssel geschrieben werden. Die Mapping-Seite stellt diese Zuweisung in Form von gruppierten Tabellen dar. Für jedes Feld können Sie:

• Den ursprünglichen AS24-Feldnamen und den zugrunde liegenden WordPress-Metaschlüssel einsehen.
• Das Label anpassen, das von den Templates für dieses Feld verwendet wird.
• 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 Metaschlüssel) 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 Anpassungen 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

1. Öffnen Sie Car Market Hub → Mapping.
2. Tippen Sie optional einen Suchbegriff in das Feld Felder durchsuchen ein, um Zeilen über alle Gruppen hinweg nach Feldname, Label oder Metaschlüssel zu filtern. Während der Eingabe zeigt die Suchleiste eine Live-Anzahl (N Treffer) der übereinstimmenden Zeilen an.
3. 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.
4. Verwenden Sie den Schalter Sichtbar, um das Feld in den Frontend-Templates auszublenden.
5. Klicken Sie unten im Abschnitt auf Mapping-Einstellungen speichern. Die Änderungen werden sofort beim nächsten Laden der Frontend-Seite wirksam.

Ausstattungs- / Merkmalscodes anpassen

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

Aktuelles Mapping exportieren

1. Öffnen Sie die Karte Exportieren & Zurücksetzen.
2. Klicken Sie auf JSON exportieren oder CSV exportieren, um ein Abbild der aktuellen Mapping-Konfiguration einschliesslich der Label- und Sichtbarkeitsanpassungen herunterzuladen.

Alle Anpassungen zurücksetzen

1. Öffnen Sie die Karte Exportieren & Zurücksetzen.
2. Klicken Sie auf Auf Standardwerte zurücksetzen. Alle benutzerdefinierten Labels und Sichtbarkeitsanpassungen 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 & Masse – Karosserieform, Aussen- und Innenfarbe, Sitzplätze, Anzahl Türen, physische Masse einschliesslich Kofferraumvolumen.
• Motor & Antrieb – Treibstoffart, Antriebssystem, Getriebe, Hubraum, Zylinderkonfiguration, Leistungsdaten.
• Verbrauch, Emissionen & Energie – Treibstoff- 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, Kilometerstand, Inspektionsstatus.
• Gewicht, Anhängelast & Nutzlast – Leergewicht, zulässiges Gesamtgewicht, Nutzlast, gebremste Anhängelast.
• Preis & Garantie – Verkaufspreis, Listenpreis des Herstellers, vollständige Garantiedetails (Art, Dauer, Kilometerbegrenzung).
• Beschreibung & Medien – Teaser-Text des Inserats, vollständige Beschreibung, Bildergalerie-Felder.

Steuerelemente pro Feld

Exportieren & Zurücksetzen

Betriebliche Hinweise

• Alle Anpassungen werden in einer einzigen WordPress-Option gespeichert, nicht in den Metadaten der einzelnen Beiträge. Dies bedeutet, dass Änderungen sofort für alle importierten Fahrzeuge wirksam werden, ohne dass die 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ä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 Anpassung vornehmen.
• Die Mapping-Seite ändert nicht, wie Daten importiert werden; sie 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 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 der entsprechenden 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://output-Stream von PHP; 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 Anpassungen. 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).

Verwandte Dokumente

• Layout Manager-Referenz
• Settings Reference
• Referenz zum Fahrzeug-Importer
• Referenz zu Import & Limits