Car Importer Reference

This document is a reference for the Car Importer screen of the ADP Car Market Hub plugin (Car Market Hub → Car Importer). It explains the two tables on the page (pending vs. imported vehicles), the actions you can take, and how search and pagination behave.

When to use this document

Use this reference when you need to import individual vehicles, re-import a vehicle to refresh its data, or remove imported vehicles from WordPress. For automatic, scheduled imports of the full inventory, see Import And Limits Reference.

Overview

The Car Importer screen presents two tables when applicable:

1. Vehicles not yet imported — listings that exist on AutoScout24 for your configured Seller IDs but have no corresponding post in WordPress yet. The table is shown only when at least one such vehicle exists.
2. Imported Vehicles — vehicles already imported into the local WordPress database (the as24ci_car custom post type). These rows can be re-imported (to refresh data and images) or deleted.

Both tables share the same shared-table layout: top toolbar with bulk actions and per-page selector, search box, paginated rows, and a matching bottom toolbar.

Requirements or prerequisites

• Valid API credentials and at least one Seller ID configured under Settings.
• A working API connection (the Dashboard banner shows the current status).
• An active plugin license. Imports are blocked with a license error if no valid license is present (see Settings Reference).
• Permission to manage the plugin.

Step by step instructions

Import individual vehicles from the pending list

1. Open Car Market Hub → Car Importer.
2. Locate the Vehicles not yet imported card at the top of the page (visible only when pending listings exist).
3. Optionally use the Search field to filter by title, ID or seller ID.
4. To import a single listing, click the per-row Import button on that row.
5. To import several at once, select rows using the row checkboxes, choose Import selected in the bulk action dropdown and click Apply.
6. Wait for the result notice. A success notice reports inserted, updated and error counts.

Re-import imported vehicles

1. In the Imported Vehicles card, click the Re-import (refresh icon) button on a single row to refresh just that vehicle, or select several rows, choose Re-import selected in the bulk action dropdown and click Apply.
2. The plugin pulls fresh data from AutoScout24 for the selected listings using the first configured Seller ID.

Delete imported vehicles

1. In the Imported Vehicles card, click the Delete (trash icon) button on a single row, or select several rows, choose Delete selected in the bulk action dropdown and click Apply.
2. Confirm the destructive action in the modal.
3. The imported cars and their imported images are removed. Items that no longer existed are reported as skipped; errors are reported separately.

Import the full inventory in batches

The Car Importer screen is for working with individual vehicles. To process the entire inventory in batches, use the Start Import Now wizard on the Import & Limits screen instead. Detailed reference for the wizard, scheduling and limits is in Import And Limits Reference.

Configuration reference

Pending vehicles table

Imported vehicles table

The imported table also shows these columns for each vehicle:

Bulk action results

After a bulk delete, the page reports:

• the number of items deleted out of the total selected,
• the number of items skipped because they no longer existed,
• the number of items that could not be deleted because of an error,

and writes a detailed entry to the plugin log when errors occur.

After a bulk import, the page reports inserted, updated and error counts.

Import progress modal

While an import (single-row or bulk) is running, a progress modal appears on top of the page. It shows a spinner, a progress bar, an N / N count of processed vs. total items, and an elapsed-time timer. A Close button lets you dismiss the modal once the import has finished.

Operational notes

• The Imported Vehicles table reads from the local WordPress database only. It does not call the API on every page load.
• Pending listings come from a snapshot of the API and may be stale until the next sync runs. Use the Import & Limits screen to control how often that sync happens.
• Bulk import always uses the first Seller ID configured in Settings. If you manage several seller IDs and need to import from a specific one, ensure it is listed first.
• Deleting a vehicle removes its imported attachments. Manually uploaded images that are not registered as imported attachments are not affected.
• Per-page preferences are stored per WordPress user, so each editor can have their own table density.

Troubleshooting

• The pending card is not shown. All known listings have already been imported, or the API has not been queried yet. Ensure the Dashboard shows a healthy API connection and that an import has run at least once.
• "No Seller ID configured." Add at least one Seller ID under Settings → API Connection & General Settings.
• An import returns errors. Open Logs (Car Market Hub → Logs) to see the detail. Common causes are network issues, expired credentials or invalid listing IDs.
• An import is blocked with a license error. Imports require an active plugin license. Activate or re-check your license under Settings → License and Activation, then try again.
• Items show as skipped after a bulk delete. Those listings were already removed (for example by another admin or by Full Sync). No action is needed.
• A delete reports an error. Check Logs for the per-listing message; the page also notes that "details, see the log" when applicable.
• Search returns no results. The search matches listing ID, title and seller ID. Clear the search to confirm the row exists.

Related documents

• Settings Reference
• Import And Limits Reference
• Logs Reference
• Tools Reference