Documentation · Troubleshooting
Troubleshooting FAQ
This document answers the most frequently asked troubleshooting questions for the ADP Car Market Hub plugin. For detailed step-by-step guides, follow the links to the relevant troubleshooting documents.
General
The plugin menu is missing from the WordPress admin after activation.
The plugin admin is only accessible to WordPress users with the manage_as24_imports capability, which is assigned to the administrator role during activation. Log in as a WordPress Administrator. If the menu is still missing, deactivate and reactivate the plugin to re-run the capability assignment. See Permission Errors.
I can see the plugin admin but all the buttons return "Permission denied".
All plugin AJAX actions and form submissions check the manage_as24_imports capability. If your user account was granted administrator status after the plugin was activated, the capability may not have been assigned. Deactivate and reactivate the plugin, or ask a super admin to verify your role. See Permission Errors.
How do I check what the plugin is doing?
Open the Logs tab in the plugin admin. The log records all import runs, errors, image downloads, and system events. For a downloadable diagnostics export (JSON or ZIP), use the System & Help tab. See Cron Errors and Import Errors.
Licensing
A feature shows "not active for this license" or a whole tab is replaced by a lock screen.
Several capabilities (Market Insights, the AI Assistant and Content Studio, among others) are governed by your ADP Car Market Hub plugin license. When the license does not include a feature, that feature shows a friendly "not included in this license" notice and its actions are not performed. When the license itself is not operational (for example expired or unverified), operational actions such as imports are paused and the affected admin areas show a license lock screen. Existing vehicle pages and data are not deleted in either case. Contact ADP Car Market Hub support to enable a feature or to restore an expired or suspended license. See Market Insights Issues.
Imports stopped running and the log mentions the license.
When the license is expired, suspended or cannot be verified beyond the grace window, operational actions such as imports and the daily pricing analysis are paused (they "fail closed"). No posts, meta or media are deleted as a result. Restore or renew the license to resume normal operation.
Setup Wizard
The "Welcome to ADP Car Market Hub" setup notice does not appear.
The notice is only shown when a first-activation timestamp has been recorded and the wizard has not been completed or skipped, and the current user must have the plugin's management capability. Plugin upgrades that do not trigger a fresh activation do not display the notice on existing installations. You can always open the wizard manually from Car Market Hub → Tools → Setup Wizard or from the Run Setup Wizard link on the Dashboard. See Setup Wizard Reference.
I skipped the wizard. How do I open it again?
Open Car Market Hub → Tools and click the Setup Wizard card, or use the Run Setup Wizard link near the top of Car Market Hub → Dashboard. The wizard remains reachable at wp-admin/admin.php?page=as24ci-setup-wizard even after it has been skipped or completed.
The wizard did not create my pages.
Either the Skip option was selected for that page on Step 4, an existing page with the same title was reused (the wizard de-duplicates by title to avoid creating duplicates), or the corresponding option (as24ci_page_archive_id, as24ci_page_compare_id, as24ci_page_favorites_id) already pointed to a published page. Open the WordPress Pages list to confirm. The wizard never deletes existing pages.
The Client Secret field is empty when I re-open Step 3.
This is by design. The stored Client Secret is never re-rendered into the admin HTML, in the wizard or on the Settings tab. Submitting the form with the field left empty preserves the existing stored secret. Submitting a non-empty value replaces it.
Analytics is not enabled after a Live setup.
In Live mode the analytics toggle is unchecked by default and must be enabled explicitly. Re-open the wizard and tick the analytics toggle on Step 5, or enable analytics on the Analytics tab. Confirm cookie consent and privacy requirements first. See Analytics Retention.
Demo data was not installed.
Demo data is only installed when Demo setup is selected on Step 1 and the wizard is finished with Install Demo Data and Finish on Step 6. Live setup does not install demo data. Demo data can also be installed at any time from the Demo Data card on Car Market Hub → Tools.
Compare or Favorites pages are empty after a demo installation.
Compare and Favorites are client-state features that read from the visitor's browser localStorage. The demo installer provides a fallback that seeds localStorage on first page load. Open the Cars, Compare or Favorites page once in the same browser session to trigger the seeding.
Will the wizard overwrite my existing settings if I run it again?
No. The wizard only writes options whose form fields the admin actually submits. Re-running it partway through never wipes a setting that was not on the submitted form. The Client Secret is preserved when the field is left empty. Activation and reactivation of the plugin are also non-destructive.
API and Connection
The connection test fails with "Missing API credentials".
The API Base URL, Client ID, or Client Secret is empty or incorrect. Open the plugin Settings tab, confirm all three fields are filled in, and save. See API Connection Errors.
The access token keeps expiring and imports fail.
The plugin caches the access token in the as24ci_access_token transient. If the token endpoint returns a very short expires_in value, the token may expire before the import completes. Delete the transient via WP-CLI (wp transient delete as24ci_access_token) and retry. If the problem recurs, contact your API provider to confirm the token validity period. See API Connection Errors.
Import returns zero vehicles even though my AutoScout24 account has listings.
The most common causes are: the Seller ID is incorrect, the listings are not active or live on AutoScout24, or the API credentials do not have access to the configured Seller ID. Verify all four settings (Base URL, Client ID, Client Secret, Seller ID) and check the plugin log for specific error messages. See API Connection Errors and Import Errors.
Importing
Vehicles are imported as drafts instead of being published automatically.
The default post status is configurable. Open the plugin Importer or Settings tab and check the Default Post Status setting. Change it from draft to publish if you want vehicles to appear on the site immediately after import. Note that importing as draft is the conservative default on new installations. See Import Errors.
Some vehicle fields are empty after import.
The import maps API response fields to WordPress post meta using the plugin's field mapping configuration. If a field is empty, either the AutoScout24 listing does not contain a value for that field, or the field mapping has been modified. Check the Field Mapping tab in the plugin admin and verify that the relevant fields are correctly mapped. See Import Errors.
The automatic import is not running.
Automatic imports require the Auto Import option to be enabled and WP-Cron to be working. Open the Import & Limits → Automation tab to confirm auto import is on and a schedule is configured. Then check the System & Help tab to confirm the as24ci_scheduled_import event is scheduled. If DISABLE_WP_CRON is set to true in wp-config.php, WP-Cron will not fire and an external cron trigger must be configured. See Cron Errors.
Images
Vehicles are imported but have no images.
Image import is controlled by the Import Images toggle in the Importer settings. Confirm it is enabled. If it is enabled but images are still missing, open the plugin log and search for Image download failed or media_handle_sideload failed to identify the specific error. Common causes include insufficient disk space, missing write permissions on wp-content/uploads, and PHP memory limits. See Image Import Errors.
Some images are missing and others were imported successfully.
The plugin processes images via a background queue (the image queue worker). Images that could not be downloaded in the main import run are retried asynchronously. Check the System & Help tab for the image queue size and last run time. You can also trigger the queue manually using the Run Image Queue button. See Image Import Errors.
Converted WebP images are not being generated.
WebP conversion requires either the GD extension with imagewebp support or the Imagick extension. Confirm that one of these is available on your server (check Tools → Site Health → Info → Server in WordPress). WebP conversion is disabled by default. Enable it in the Importer settings when your server supports it. See Image Import Errors.
Frontend Display
The vehicle archive page shows a 404 error.
The most common cause is that WordPress permalink rewrite rules need to be flushed. Go to Settings → Permalinks and click Save Changes without making any changes. This regenerates the rewrite rules. See Frontend Display Issues.
The vehicle listing page shows no vehicles even though vehicles are imported.
Vehicles must have publish status to appear on the archive. Check whether vehicles are in draft status and publish them. Also confirm that no active filter or search query is hiding results, and that no caching plugin is serving a stale page. See Frontend Display Issues.
The vehicle archive or detail pages look broken or unstyled.
The plugin loads its CSS and JavaScript only on pages where a vehicle shortcode is present in post_content, or on standard CPT archive and single templates. If your theme uses a page builder or custom template that does not render post_content directly, the assets may not load. Add the [as24ci_archive] shortcode directly to the page content field. See Frontend Display Issues and Shortcode Issues.
Shortcodes
A shortcode is displayed as plain text on the page.
Shortcode processing is disabled in some contexts (for example, page builders, widget areas, or custom template files that do not call do_shortcode). Verify that the shortcode is placed in the standard WordPress Content field of a page or post, not in a widget, custom field, or PHP template. See Shortcode Issues.
The [as24ci_archive] shortcode outputs nothing.
If the shortcode is in the correct position but outputs nothing, the most likely cause is that no published vehicles exist. Check that vehicles are imported and published. Also confirm that the shortcode attribute values are valid — for example, per_page must be a positive integer. See Shortcode Issues.
Email and Leads
No email arrives when a visitor submits an inquiry form.
The plugin sends notification emails using wp_mail(). If no email arrives, check whether your WordPress site is correctly configured for email delivery. Many hosting environments require an SMTP plugin to reliably send mail. Also verify that the recipient address configured in the plugin settings is correct and not being filtered by a spam folder. See Email and Lead Errors.
The lead is saved in the Leads admin but no email notification is sent.
Lead data is saved to the as24ci_lead custom post type regardless of email delivery. Email delivery is a separate process. Check the recipient address configuration (global override setting → seller profile email → post author email → WordPress admin email fallback) and test with a simple SMTP delivery plugin. See Email and Lead Errors.
The contact form returns a validation error but all fields appear to be filled in.
The form validates name, email address, message, and consent checkbox server-side. A honeypot anti-spam field must also be empty. If the error persists, a browser autofill may have filled the honeypot field, or a JavaScript conflict may be interfering with the form. Try submitting in a private browser window with no extensions active. See Email and Lead Errors.
Market Insights
All vehicles show no_data in the Market Score column.
The no_data status is returned when a vehicle has no price stored (_as24ci_price is empty or zero). Verify that vehicles were imported with a price. If they were, re-run the import or manually trigger the pricing analysis by deactivating and reactivating the plugin. See Market Insights Issues.
Days on Lot shows 0 or an unexpectedly large number.
A value of 0 can mean the vehicle was published today or has a future-dated scheduled publish. Very large values indicate a corrupted post date (for example, imported from a zero-date record). Check the vehicle's publish date in the post list table. See Market Insights Issues.
PDF Datasheet
The datasheet URL (?as24ci_pdf=123) returns a 404 error.
Either the PDF Datasheet feature is not enabled, the post ID is wrong, or the vehicle is not in publish status. Enable the feature in the plugin settings, flush permalinks, and confirm the vehicle is published. See PDF Datasheet Issues.
The datasheet shows no images.
Confirm that images were imported for the vehicle and that the Show Gallery toggle is enabled in the PDF Manager settings. The datasheet shows a maximum of 5 images. See PDF Datasheet Issues.