Documentation · Operations and Maintenance

Daily Operation

This document describes the routine daily checks that a site administrator or dealership manager should carry out to confirm that the ADP Car Market Hub plugin is operating correctly on a production WordPress site.

When to use this document

Read this document if you are responsible for the day-to-day operation of a live site that uses the plugin to import and display vehicle listings from AutoScout24. These checks are designed to be completed quickly and to catch problems before they affect visitors or leads.

Overview

The plugin runs import jobs automatically using WP-Cron or an external server cron, downloads vehicle images asynchronously via an image queue, and stores visitor events and customer inquiries in the WordPress database. Daily checks confirm that these background processes are running as expected and that no errors have accumulated.

The WordPress admin panel provides a Dashboard tab and a Logs tab that surface the most relevant operational data in one place.

Requirements

  • Administrator account with the manage_as24_imports capability, which is granted to WordPress administrators on plugin activation.
  • Access to WordPress Admin → ADP Car Market Hub (the plugin admin menu).

Daily checks

1. Confirm the last import run

  1. Open ADP Car Market Hub → Dashboard.
  2. Locate the KPI row. It displays the total number of imported vehicles, new vehicles added in the last seven days, and the timestamp of the most recent import run.
  3. Verify that the last import timestamp matches the expected schedule. If the import has not run since the last expected interval, investigate the automation settings or cron configuration.
  4. For more detail, open ADP Car Market Hub → Import & Limits and inspect the Last run time and the Last run status (inserted, updated, skipped, errors).

2. Check for import errors

  1. Open ADP Car Market Hub → Logs.
  2. The Recent Errors panel shows the most recent error-level entries from the current log file. If any errors are present, read them and investigate the cause.
  3. The Recent Warnings panel shows warning-level entries that may indicate degraded operation (for example, partial image failures or API rate-limit responses).
  4. An empty errors panel is the expected healthy state.

3. Review new leads

  1. Open ADP Car Market Hub → Leads (or navigate to the Leads tab inside the plugin admin).
  2. Review any leads with status New that have arrived since the previous day.
  3. Assign a status (Contacted, Closed, or Spam) to processed leads so the queue remains manageable.
  4. Verify that lead notification emails were delivered by checking the inbox of the configured recipient address. The recipient is set under Settings → Lead recipient email.

4. Verify the image queue

  1. Open ADP Car Market Hub → System & Help.
  2. Locate the image queue section. When the image queue is enabled, remaining images are processed asynchronously after each import. A small queue backlog is normal. A very large or stale backlog (the System & Help tab displays a warning when the queue exceeds the configured threshold) may indicate that the image-queue cron hook is not firing.
  3. If the queue size is unexpectedly high, use the Trigger image queue now button in the Import & Limits tab to process it manually, then investigate the cron setup.

5. Check the API connection

  1. Open ADP Car Market Hub → System & Help.
  2. The connection status line confirms whether the plugin can reach the AutoScout24 API with the currently configured credentials.
  3. A status of Connected to AutoScout24 – token valid and API reachable is the expected healthy state.
  4. If the status shows an error, verify the Client ID, Client Secret, and Seller ID settings under ADP Car Market Hub → Settings.

Configuration reference

Setting locationRelevant optionPurpose
Import & Limits tabAuto Import EnabledEnables or disables automatic scheduled imports
Import & Limits tabScheduleImport frequency (hourly, every 6 hours, twice daily, daily, or custom interval)
Import & Limits tabMax vehicles per runLimits the number of vehicles processed in a single cron run (0 = unlimited)
Import & Limits tabImage queue modeWhen enabled, only the first image is downloaded immediately; remaining images are queued
Settings tabLead recipient emailOverride email address for lead notifications
Logs tabVerbose loggingWhen enabled, logs a line for every vehicle and every image action

Operational notes

  • The plugin uses a transient lock (as24ci_cron_import_running) to prevent overlapping import runs. If a previous run terminated unexpectedly, the lock is automatically cleared after its TTL (40 minutes).
  • The log file is stored in the WordPress uploads directory under as24ci-logs/adp-car-market-hub.log. The directory is protected from public web access by an .htaccess file and a silent index.php.
  • Log files are automatically rotated when they exceed 10 MB. Rotated archives are deleted after 7 days.
  • The Dashboard tab data is cached for three minutes. If you have just triggered a manual import, wait a few minutes before checking counts.

Troubleshooting

SymptomLikely causeCheck
Last import time is older than expectedWP-Cron not firing or site has low trafficReview cron mode in System & Help tab; consider switching to server cron
Errors in the log after an importAPI credentials expired or invalid, or network issueCheck API connection status in System & Help tab; verify credentials in Settings
No new leads appearing despite visitor activityContact form not configured, or email delivery failingTest the contact form manually; check the lead recipient email setting
Image queue growing but not decreasingImage-queue cron hook not runningTrigger the image queue manually from the Import & Limits tab; check server cron or WP-Cron health
Dashboard counts appear staleTransient cacheWait three minutes for the three-minute cache to expire, then reload