Documentatie · Beheerdersreferentie

Mapping-referentie

Dit document is een referentie voor het Mapping-scherm van de ADP Car Market Hub-plugin (Car Market Hub → Mapping). Het legt uit hoe binnenkomende AutoScout24-velden worden gemapped naar WordPress, wat u per veld kunt aanpassen en hoe u de configuratie kunt exporteren of resetten.

Wanneer u dit document moet gebruiken

Lees dit wanneer u een veld dat in de frontend verschijnt een ander label wilt geven, een veld wilt verbergen dat niet aan bezoekers mag worden getoond, of de mapping wilt controleren tussen AutoScout24-bronvelden en de WordPress meta keys die door de plugin-templates worden gebruikt.

Overzicht

Elk voertuig dat vanuit AutoScout24 wordt geïmporteerd, wordt opgeslagen als een as24ci_car-bericht in WordPress, waarbij de bronvelden naar specifieke post-meta keys worden geschreven. Het Mapping-scherm toont die mapping als een reeks gegroepeerde tabellen. Voor elk veld kunt u:

  • De originele AS24-veldnaam en de onderliggende WordPress meta key bekijken.
  • Het Label aanpassen dat templates voor dat veld gebruiken.
  • De Zichtbaar-status van het veld in- of uitschakelen om het in de frontend te verbergen.

Een aparte kaart Uitrusting & kenmerken toont elke ondersteunde uitrustingscode (opgeslagen als een geserialiseerde array in een enkele meta key) met dezelfde regelaars voor Label en Zichtbaar. Met een kaart Exporteren & Resetten kunt u een back-up van de configuratie maken als JSON of CSV, of alle overschrijvingen terugzetten naar de standaardwaarden van de plugin.

Vereisten of randvoorwaarden

  • Machtiging om de plugin te beheren (dezelfde rechten die elders in Car Market Hub worden gebruikt).
  • Ten minste één geïmporteerd voertuig, zodat wijzigingen in labels en zichtbaarheid zichtbaar zijn op de frontend.

Stapsgewijze instructies

Een veldlabel aanpassen of een veld verbergen

  1. Open Car Market Hub → Mapping.
  2. Typ optioneel in Velden zoeken om rijen in alle groepen te filteren op veldnaam, label of meta key. Terwijl u typt, toont de zoekbalk een live aantal (N resultaten) van de rijen die overeenkomen.
  3. Bewerk in de relevante groepstabel de kolom Label voor het veld dat u een nieuw label wilt geven. Lege waarden vallen terug op het standaard vertaalde label.
  4. Gebruik de schakelaar Zichtbaar om het veld te verbergen in frontend-templates.
  5. Klik op Mapping-instellingen opslaan onderaan de sectie. Wijzigingen worden onmiddellijk toegepast bij de volgende keer dat een frontend-pagina wordt geladen.

Uitrustings- / kenmerken-codes aanpassen

  1. Scrol naar de kaart Uitrusting & kenmerken.
  2. Bewerk de kolom Label voor elke kenmerkcode die u onder een andere naam wilt weergeven.
  3. Schakel Zichtbaar uit voor elke kenmerkcode die niet mag worden getoond.
  4. Klik op Mapping-instellingen opslaan.

De huidige mapping exporteren

  1. Open de kaart Exporteren & Resetten.
  2. Klik op JSON exporteren of CSV exporteren om een momentopname van de huidige mapping-configuratie inclusief label- en zichtbaarheidsoverschrijvingen te downloaden.

Alle overschrijvingen resetten

  1. Open de kaart Exporteren & Resetten.
  2. Klik op Herstellen naar standaardwaarden. Alle aangepaste labels en zichtbaarheidsoverschrijvingen worden verwijderd; elk veld keert terug naar zijn ingebouwde standaardlabel en zichtbare status.

Configuratiereferentie

Veldgroepen

De standaard veldenkaart is georganiseerd in de volgende logische groepen (elke groep toont de AS24-velden die deze bevat en een korte beschrijving):

  • Identificatie & status — kernidentificatoren, verkopersreferenties, tijdstempels en statusvlaggen van de advertentie.
  • Voertuigbasis / type — merk, model, versie-identificatoren, certificeringsdetails, voertuigcategorie.
  • Carrosserie & afmetingen — carrosserievorm, exterieur- en interieurkleur, zitplaatsen, aantal deuren, fysieke afmetingen inclusief kofferbakmaten.
  • Motor & transmissie — brandstoftype, aandrijfsysteem, transmissie, cilinderinhoud, cilinderconfiguratie, vermogenscijfers.
  • Verbruik, emissies & energie — brandstof- en gasverbruik (binnen de bebouwde kom / buiten de bebouwde kom / gecombineerd), CO₂-emissies, emissieklasse, energielabel.
  • Elektrificatie & laden — batterijcapaciteit, gezondheid, huurprijs, elektrisch bereik, AC/DC-laadstekkertypes, vermogenswaarden, laadtijden.
  • Kilometerstand & registratie — voertuigstaat, datum van eerste toelating, kilometerstand, inspectiestatus.
  • Gewicht, trekken & laadvermogen — rijklaar gewicht, maximaal toelaatbaar gewicht, laadvermogen, geremd trekgewicht.
  • Prijs & garantie — verkoopprijs, catalogusprijs van de fabrikant, volledige garantiedetails (type, duur, kilometerdekking).
  • Beschrijving & media — teasertekst van de advertentie, volledige beschrijving, velden voor de fotogalerij.

Regelaars per veld

KolomOpmerkingen
AS24-veldDe originele AutoScout24-veldnaam (alleen-lezen).
LabelBewerkbaar. Leeg = standaard vertaald label. Maximale lengte: 120 tekens. Rijen met een opgeslagen labeloverschrijving tonen een aangepast-badge.
WordPress meta keyDe post-meta key waaronder de waarde is opgeslagen (alleen-lezen).
ZichtbaarSchakelaar. Uitgeschakeld betekent dat templates dit veld overslaan, zelfs als het geïmporteerde voertuig er gegevens voor heeft.

Exporteren & Resetten

ActieOpmerkingen
JSON exporterenStreamt een JSON-bestand met de opgeslagen overschrijvingen.
CSV exporterenStreamt een CSV-bestand met dezelfde gegevens.
Herstellen naar standaardwaardenVerwijdert de volledige overschrijvingsoptie; elk veld valt terug op zijn ingebouwde standaardwaarde.

Operationele opmerkingen

  • Alle overschrijvingen worden opgeslagen in een enkele WordPress-optie, niet in individuele post-meta. Dit betekent dat wijzigingen direct van toepassing zijn op alle geïmporteerde voertuigen zonder dat gegevens opnieuw hoeven te worden geïmporteerd.
  • Het opslaan van het formulier slaat de zichtbare status voor elk bekend veld op. Alles wat niet in het formulier aanwezig is, wordt standaard als zichtbaar behandeld.
  • Veldlabels zijn klaar voor vertaling. Als uw site in een andere taal dan het Engels is, toont de kolom Label de vertaalde standaardwaarde totdat u een overschrijving instelt.
  • Het mapping-scherm verandert niets aan de manier waarop gegevens worden geïmporteerd; het regelt alleen hoe opgeslagen gegevens worden gelabeld en of ze op de frontend verschijnen. Zie de Beheerdersreferentie voor Import & Limieten om te wijzigen welke afbeeldingen of gegevens worden gedownload.
  • Het hier verbergen van een veld heeft ook invloed op de veldzichtbaarheid die per zone is geconfigureerd in de Layout Manager, omdat beide lagen een veld moeten toestaan om het te kunnen renderen.

Probleemoplossing

  • Een labelwijziging verschijnt niet. Controleer of u op Mapping-instellingen opslaan hebt geklikt in dezelfde kaart en of eventuele frontend- of CDN-caches zijn geleegd.
  • Een veld is nog steeds verborgen na het inschakelen ervan. Controleer de Layout Manager — het bijbehorende blok of de zone moet het veld ook bevatten.
  • De export-download is leeg of mislukt. Zorg ervoor dat geen enkele andere plugin admin-post.php-verzoeken onderschept en dat de gebruiker de beheerdersrechten heeft. Het CSV-pad maakt gebruik van de php://output-stream van PHP; sommige restrictieve hosts kunnen dit blokkeren. Controleer dit in de huidige plugin-versie alvorens te publiceren.
  • Herstellen naar standaardwaarden deed niets. Resetten verwijdert alleen overschrijvingen. Als labels nog steeds aangepast lijken, hebt u mogelijk een actief vertaalbestand dat het standaardlabel overschrijft.
  • Wijzigingen in uitrustingslabels worden niet getoond bij een voertuig. Dat voertuig is mogelijk geïmporteerd voordat het uitrustingsveld was gevuld, of de kenmerkcode is verborgen in Uitrusting & kenmerken. Controleer de schakelaar Zichtbaar opnieuw en importeer het voertuig indien nodig opnieuw (zie de Beheerdersreferentie voor de Car Importer).

Gerelateerde documenten