Documentation · Overview

Feature Overview

This document summarises the features of the ADP Car Market Hub plugin and points to the detailed documentation for each area.

When to use this document

Read this document when you need a one-page map of what the plugin can do, when you are deciding which optional features to enable, or when you want to find the right detailed reference quickly.

Overview

The plugin groups its functionality into the following feature areas. Each area is delivered by one or more admin tabs and is documented in depth in the corresponding section of this manual.

Import and synchronisation

  • Imports vehicle listings from the configured AutoScout24 API endpoint into the as24ci_car custom post type.
  • Imports vehicle images, with optional WebP conversion (requires GD or Imagick) and a configurable maximum number of images per vehicle.
  • Change detection: a content hash and an image hash are stored per vehicle so unchanged listings are skipped on subsequent runs.
  • Optional Full Sync: vehicles that disappear from the remote feed are deleted locally, including their imported attachments. Opt-in for safety.
  • Manual full imports through the Batch-Wizard with adaptive batch size, live progress, ETA and pause/resume/abort controls.

See Import Engine and Car Importer Reference.

Automation and scheduling

  • Built-in WP-Cron scheduler with hourly, every-6-hours, twice-daily, daily and custom intervals (minimum 15 minutes).
  • Token-secured REST cron endpoint for external system cron triggers.
  • Configurable per-run vehicle limit and image-queue mode for cron robustness on shared hosts.
  • Image queue worker that processes attachments asynchronously to prevent PHP timeouts.

See Cron Events And Scheduler and Server Cron Setup.

Vehicle data model

  • One row per vehicle in a dedicated as24_vehicles table with indexed columns for common queries.
  • 15 native WordPress vehicle-attribute taxonomies (brand, model, body type, condition, fuel type, transmission, drive, exterior/interior colour, emission standard, energy label, vehicle category, cylinder arrangement, warranty type, warranty details).
  • Backwards-compatibility post meta keys mirror the most-used fields for theme compatibility.
  • A manual_overrides layer lets administrators pin field values that survive re-imports.

See Database Schema, Custom Post Types And Taxonomies and Data Model.

Front-end presentation

  • Bundled archive and single-vehicle templates with image gallery, equipment list, vehicle details, contact form and optional add-ons.
  • Layout Manager: configure search filters, archive cards, single-vehicle blocks and the favorites/compare layout from the admin.
  • Theme override paths for archive-as24ci_car.php and single-as24ci_car.php.
  • Shortcodes for the archive, search filter, compare page, favorites page and location/opening-hours cards. See Shortcode Reference.
  • Optional Favorites / Wishlist (browser local storage) and Vehicle Compare flows on the front-end, where the corresponding shortcodes or layouts are placed.
  • Optional Financing Calculator on vehicle detail pages, with configurable default rate, term, down payment and placement (active where enabled in Design & Styles).
  • Optional per-vehicle PDF datasheet generation and download, where the PDF Manager is configured and the feature is enabled.
  • Optional Locations / opening-hours cards for dealer locations, where the Locations area is populated and the corresponding shortcode is placed.

Leads and contact form

  • Built-in contact form on single vehicle pages, stored as as24ci_lead posts.
  • Configurable visible fields, consent checkbox, success and error messages.
  • Customisable email templates for the dealer notification and the customer confirmation.
  • CSV export from the Leads admin tab.

See Lead Storage And Processing and Leads Reference.

Sales contacts (CMH Team)

  • Plugin-managed dealership sales contacts, maintained in the separate CMH Team top-level menu. Team members do not need a WordPress login.
  • Each contact stores a name, optional photo, email and phone, shown as the contact card on vehicle detail pages.
  • Contacts can be assigned per vehicle, per dealer location/seller, or as a global default, with manual choices preserved across re-imports and optional automatic assignment rules.
  • The resolved contact is used as a preferred recipient for leads, with an optional copy to the general dealership email.

See CMH Team and Contact Routing.

Test Drive booking

  • Optional Test Drive form on vehicle detail pages.
  • Configurable available weekdays, daily time window, slot duration and blackout dates.
  • Booking requests are stored as leads and forwarded to the configured recipient email.

See Test Drive Requests.

Search Alerts (Smart Stock Alerts)

  • Visitors can subscribe to saved search criteria and receive a notification when a matching vehicle is imported.
  • GDPR-compliant Double-Opt-In flow: subscribers must confirm via an email link before any notifications are sent.
  • Notifications are triggered automatically when matching vehicles are imported.
  • Subscriptions are stored in the dedicated as24ci_search_agents table and managed in the Search Alerts admin tab.

See Search Alerts Frontend, Search Alerts Reference and Search Alerts Double Opt In.

AI Assistant (optional)

  • Generates vehicle descriptions, SEO meta titles and descriptions, image alt texts and equipment highlights.
  • Uses the managed Google Gemini configuration in ADP Car Market Hub. No provider selection, model selection or API key entry is required in the WordPress backend; customer-specific AI provisioning is completed by AD Promotion after installation.
  • Configurable language, tone, target length and a custom prompt template.
  • Background queue processes AI work asynchronously through a custom 5-minute WP-Cron interval.

See AI Assistant Reference and AI Assistant Technical Notes.

Content Studio (optional)

  • Turns a vehicle already in the inventory into ready-to-post marketing text for social media and other channels: Facebook, Instagram, TikTok, Google Business Profile, WhatsApp, a dealership newsletter and the website.
  • Generation can run in one or more languages at once, with a configurable default tone, dealership brand voice and mandatory compliance/disclaimer guidance.
  • Text generation uses a Google API key owned by the dealership and stored encrypted; the plugin produces text (and, for some formats, a draft marketing image) to copy and publish manually and never posts to social networks on your behalf.
  • Available where included in the licence; reads vehicle data only and writes solely to its own Content Studio records.

See Content Studio Reference.

Analytics

  • Server-side tracking of page views, archive/compare/favorites views, filter searches, contact-open events and lead submissions.
  • Daily charts and a top-vehicle ranking on the Analytics admin tab.
  • Configurable retention window with a daily cleanup cron.
  • Optional consent gating through the as24ci_analytics_consent_check filter.

See Analytics Tracking and Analytics Retention.

Market Insights (optional)

  • Aggregated market intelligence and pricing assessment views for the local inventory, surfaced through the Market Insights admin page.
  • Active where configured; depending on the installed plugin configuration, some panels may require an additional managed data source to be provisioned by AD Promotion.

EnVKV / Energy disclosure (optional)

  • Configuration for the German Energy Consumption Disclosure Ordinance (EnVKV / Pkw-EnVKV), including consumption, emission and energy-label fields used on archive cards, vehicle detail pages and the PDF datasheet.
  • Active where enabled and configured for the relevant markets; can be left untouched on installations that do not require EnVKV disclosure.

Webhooks (optional)

  • Outbound new_lead and new_import events fired to administrator-configured URLs.
  • Optional HMAC-SHA256 signature for receiver verification.
  • Bounded retry strategy for transient failures.

See Webhooks and Webhook Event Reference.

REST API (optional)

  • Public read-only GET /wp-json/as24ci/v1/vehicles and GET /wp-json/as24ci/v1/vehicles/{id} endpoints for external consumers.
  • A favorites helper used by the front-end favorites page.
  • A public analytics tracking endpoint used by the front-end script.
  • A token-protected GET /wp-json/as24ci/v1/cron-import endpoint for external schedulers.

See REST API Endpoints and REST Endpoint Reference.

Design and layout

  • Brand colours, typography, badges, gallery configuration and custom CSS via the Design & Styles tab.
  • Layout Manager arranges the search filters, archive cards, single-vehicle blocks and the compare/favorites layouts without code.
  • Mapping tab edits the labels and visibility of every imported field.

See Design And Styles Reference, Layout Manager Reference and Mapping Reference.

Operations and maintenance

  • Verbose logging with auto-rotation at a 10 MB cap.
  • System & Help tab with environment checks, cron status, image-queue status, log status, connection test and diagnostics export.
  • Tools tab for single-post diagnostics, dry-run imports and import/export of plugin settings.

See Operations and Maintenance.