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_importscapability, 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
- Open ADP Car Market Hub → Dashboard.
- 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.
- 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.
- 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
- Open ADP Car Market Hub → Logs.
- 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.
- The Recent Warnings panel shows warning-level entries that may indicate degraded operation (for example, partial image failures or API rate-limit responses).
- An empty errors panel is the expected healthy state.
3. Review new leads
- Open ADP Car Market Hub → Leads (or navigate to the Leads tab inside the plugin admin).
- Review any leads with status New that have arrived since the previous day.
- Assign a status (Contacted, Closed, or Spam) to processed leads so the queue remains manageable.
- 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
- Open ADP Car Market Hub → System & Help.
- 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.
- 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
- Open ADP Car Market Hub → System & Help.
- The connection status line confirms whether the plugin can reach the AutoScout24 API with the currently configured credentials.
- A status of Connected to AutoScout24 – token valid and API reachable is the expected healthy state.
- 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 location | Relevant option | Purpose |
|---|---|---|
| Import & Limits tab | Auto Import Enabled | Enables or disables automatic scheduled imports |
| Import & Limits tab | Schedule | Import frequency (hourly, every 6 hours, twice daily, daily, or custom interval) |
| Import & Limits tab | Max vehicles per run | Limits the number of vehicles processed in a single cron run (0 = unlimited) |
| Import & Limits tab | Image queue mode | When enabled, only the first image is downloaded immediately; remaining images are queued |
| Settings tab | Lead recipient email | Override email address for lead notifications |
| Logs tab | Verbose logging | When 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.htaccessfile and a silentindex.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
| Symptom | Likely cause | Check |
|---|---|---|
| Last import time is older than expected | WP-Cron not firing or site has low traffic | Review cron mode in System & Help tab; consider switching to server cron |
| Errors in the log after an import | API credentials expired or invalid, or network issue | Check API connection status in System & Help tab; verify credentials in Settings |
| No new leads appearing despite visitor activity | Contact form not configured, or email delivery failing | Test the contact form manually; check the lead recipient email setting |
| Image queue growing but not decreasing | Image-queue cron hook not running | Trigger the image queue manually from the Import & Limits tab; check server cron or WP-Cron health |
| Dashboard counts appear stale | Transient cache | Wait three minutes for the three-minute cache to expire, then reload |