Mapping Reference

This document is a reference for the Mapping screen of the ADP Car Market Hub plugin (Car Market Hub → Mapping). It explains how incoming AutoScout24 fields are mapped into WordPress, what you can customise per field, and how to export or reset the configuration.

When to use this document

Read this when you want to relabel a field that appears in the frontend, hide a field that should not be shown to visitors, or audit the mapping between AutoScout24 source fields and the WordPress meta keys used by the plugin templates.

Overview

Each vehicle imported from AutoScout24 is stored as an as24ci_car post in WordPress, with the source fields written to dedicated post-meta keys. The Mapping screen exposes that mapping as a series of grouped tables. For every field you can:

• See the original AS24 field name and the underlying WordPress meta key.
• Customise the Label that templates use for that field.
• Toggle the field's Visible state to hide it from the frontend.

A separate Equipment & features card lists every supported equipment code (stored as a serialised array in a single meta key) with the same Label and Visible controls. An Export & Reset card lets you back up the configuration as JSON or CSV, or revert all overrides to the plugin defaults.

Requirements or prerequisites

• Permission to manage the plugin (the same capability used elsewhere in Car Market Hub).
• At least one vehicle imported, so labels and visibility changes are visible on the frontend.

Step by step instructions

Customise a field label or hide a field

1. Open Car Market Hub → Mapping.
2. Optionally type into Search fields to filter rows across all groups by field name, label, or meta key. As you type, the search bar shows a live (N matches) count of the rows that match.
3. In the relevant group table, edit the Label column for the field you want to relabel. Empty values fall back to the default translated label.
4. Use the Visible toggle to hide the field from frontend templates.
5. Click Save Mapping settings at the bottom of the section. Changes apply immediately on the next frontend page load.

Customise equipment / feature codes

1. Scroll to the Equipment & features card.
2. Edit the Label column for any feature code you want to display under a different name.
3. Toggle Visible off for any feature code that should not be shown.
4. Click Save Mapping settings.

Export the current mapping

1. Open the Export & Reset card.
2. Click Export JSON or Export CSV to download a snapshot of the current mapping configuration including label and visibility overrides.

Reset all overrides

1. Open the Export & Reset card.
2. Click Reset to defaults. All custom labels and visibility overrides are removed; every field reverts to its built-in default label and visible state.

Configuration reference

Field groups

The standard field card is organised into the following logical groups (each group lists the AS24 fields it contains and a short description):

• Identification & status — core identifiers, seller references, timestamps, and listing status flags.
• Vehicle base / type — make, model, version identifiers, certification details, vehicle category.
• Body & dimensions — body style, exterior and interior colour, seating, door count, physical dimensions including boot measurements.
• Engine & drivetrain — fuel type, drive system, transmission, displacement, cylinder configuration, power output figures.
• Consumption, emissions & energy — fuel and gas consumption (urban / extra-urban / combined), CO₂ emissions, emission standard class, energy label.
• Electrification & charging — battery capacity, health, rental price, electric range, AC/DC charging plug types, power ratings, charging times.
• Mileage & registration — vehicle condition, first registration date, odometer reading, inspection status.
• Weight, towing & payload — kerb weight, gross vehicle weight, payload capacity, braked towing limit.
• Price & warranty — sale price, manufacturer list price, full warranty details (type, duration, mileage coverage).
• Description & media — listing teaser text, full description, image gallery fields.

Per-field controls

Export & Reset

Operational notes

• All overrides are stored in a single WordPress option, not in individual post meta. This means changes apply across all imported vehicles instantly without re-importing data.
• Saving the form stores the visible state for every known field. Anything not present in the form is treated as visible by default.
• Field labels are translation-ready. If your site is in a non-English language, the Label column shows the translated default until you set an override.
• The mapping screen does not change how data is imported; it only controls how stored data is labeled and whether it appears on the frontend. To change which images or data are downloaded, see Import And Limits Reference.
• Hiding a field here also affects field visibility configured per zone in the Layout Manager, because both layers must allow a field for it to render.

Troubleshooting

• A label change does not appear. Confirm you clicked Save Mapping settings in the same card and that any frontend or CDN cache has been cleared.
• A field is still hidden after enabling it. Check the Layout Manager — the corresponding block or zone must also include the field.
• The Export download is empty or fails. Ensure no other plugin is intercepting admin-post.php requests, and that the user has the management capability. The CSV path uses PHP's php://output stream; some restrictive hosts may block it. Verify in the current plugin version before publishing.
• Reset to defaults did nothing. Reset only removes overrides. If labels still appear customised, you may have an active translation file overriding the default label.
• Equipment label changes do not show on a vehicle. That vehicle may have been imported before the equipment field was populated, or the feature code is hidden in Equipment & features. Re-check the Visible toggle and re-import the vehicle if needed (see Car Importer Reference).

Related documents

• Layout Manager Reference
• Settings Reference
• Car Importer Reference
• Import And Limits Reference