Locations Reference

This document is a reference for the Locations screen of the ADP Car Market Hub plugin (Car Market Hub → Locations). It explains how to manage dealer branches, link them to AutoScout24 seller IDs and define the opening hours that the frontend location and hours blocks will render.

When to use this document

Read this if you are an administrator or office manager and you need to:

• Add, edit, reorder or remove dealer locations.
• Map one or more AutoScout24 seller accounts to a specific branch.
• Maintain branch contact details (address, phone, email, Google Maps location).
• Maintain opening hours by category (for example Sales and Service).
• Embed location or opening-hours blocks on the website using the related shortcodes.

Overview

A location in the plugin is a structured record describing a single dealer branch. Each record contains:

• A name and a full postal address (street, ZIP, city).
• Contact channels (phone, email, Google Maps location URL).
• One or more AutoScout24 seller IDs that belong to this branch.
• One or more opening-hours categories, each with its own day/time rows.

Locations are stored as plugin options and rendered by the two location-related shortcodes:

• [as24ci_location_box] — contact card for a branch.
• [as24ci_hours_box] — opening-hours card for a branch.

Both shortcodes resolve a vehicle's branch via the seller ID stored on the vehicle. The first location in the list is treated as the default and is used as a fallback when no other match can be made.

Requirements or prerequisites

• A user with the plugin's management capability (the same role that can access the other Car Market Hub admin pages).
• At least one AutoScout24 seller ID, available from your AutoScout24 dealer account.
• The opening hours and contact details that you want to publish.

Step by step instructions

Add a new location

1. Open Car Market Hub → Locations.
2. Click + Add Location at the top of the Managed Locations card. A new card is created and the inline editor opens automatically. When no locations exist yet, an empty-state card is shown instead, reading "No locations configured yet. Click '+ Add Location'…".
3. Fill in the Location Name, Street, ZIP, City, Phone, Email and Google Maps Location fields. The Google Maps Location field is optional — when left empty the frontend generates a Google Maps search URL from the location name and address automatically.
4. Enter one or more Seller IDs, separated by commas.
5. Add at least one opening-hours category (see below).
6. Click Save Locations settings at the bottom of the editor or in the bottom save bar.

Edit, reorder or delete a location

1. On the location card, click the three-dot action menu in the top-right corner.
2. Choose: - Edit — opens the inline editor for that card. - Make Default — moves the card to position one. The card at position one is always shown with the Default badge. - Delete — marks the card for deletion. The change becomes permanent on the next save.
3. Click Save Locations settings to persist any changes.

Every location summary card also shows an Active badge, in addition to the Default badge that the first card carries.

Add opening-hours categories and rows

1. Inside the editor, scroll to the Opening Hours sub-section.
2. Click Add Category and type a category name (for example Sales or Repair & Service).
3. Click Add Row to add a day/time pair such as Monday to Friday and 08.00 – 18.00.
4. Repeat for each category. Empty rows and empty categories are discarded on save.

Configuration reference

Location fields

Opening-hours model

Each location stores an ordered list of categories. Each category has:

• A category name (free text such as Sales, Service, Spare Parts).
• A list of rows, each consisting of a days label and a time label.

Both labels are stored as plain text so that you can match the wording used in your other publications. Rows where both fields are empty are removed on save.

KPI tiles

The KPI strip at the top of the screen surfaces:

• Total Locations — total saved locations.
• Seller IDs Assigned — sum of seller IDs across all locations.
• Hours Categories — sum of opening-hours categories across all locations.
• Location Shortcode / Hours Shortcode — Active if the corresponding shortcode is registered in the current site.

Operational notes

• The first location in the list is the default. The default location is used as a fallback for the location and hours shortcodes when no seller ID match is found for a vehicle.
• AutoScout24 seller IDs are the link between an imported vehicle and a location. Each vehicle is associated with the location whose seller IDs include the vehicle's seller.
• Edits to existing locations are preserved by an internal stable ID. Reordering or renaming does not break the link to vehicles.
• The two location shortcodes accept a post_id attribute. When omitted, they use the current vehicle in the WordPress loop. See Shortcodes And Widgets Reference.
• Opening hours are presented exactly as you typed them. The plugin does not parse the day or time strings; this gives you full control over phrasing and localisation.

Troubleshooting

• A vehicle shows the wrong contact data. Confirm that the vehicle's seller ID is listed on the intended location, with no leading or trailing whitespace.
• [as24ci_location_box] falls back to the default location. No location lists the vehicle's seller ID. Add the seller ID to the correct location and save.
• Saved hours are not visible on the frontend. Confirm that at least one row has a non-empty days or time value — fully empty rows are dropped on save. Also confirm the page where the shortcode is placed actually receives the right post context.
• Changes do not persist after clicking Delete. The card is only marked for deletion in the UI. You must click Save Locations settings to commit the deletion.
• The shortcode KPI shows Inactive. Another plugin or a custom theme has unregistered the shortcode, or the plugin failed to bootstrap. Check Car Market Hub → System & Help.

Related documents

• Shortcodes And Widgets Reference
• Settings Reference
• Mapping Reference
• Leads Reference