Documentazione · Panoramica

Panoramica delle funzionalità

Questo documento riassume le funzionalità del plugin ADP Car Market Hub e rimanda alla documentazione dettagliata per ciascuna area.

Quando utilizzare questo documento

Leggi questo documento quando hai bisogno di una mappa riepilogativa di ciò che il plugin può fare, quando stai decidendo quali funzionalità opzionali abilitare o quando desideri trovare rapidamente il riferimento dettagliato corretto.

Panoramica

Il plugin raggruppa le sue funzionalità nelle seguenti aree. Ciascuna area è gestita da una o più schede di amministrazione ed è documentata in modo approfondito nella sezione corrispondente di questo manuale.

Importazione e sincronizzazione

Importa gli annunci dei veicoli dall'endpoint API AutoScout24 configurato nel custom post type as24ci_car.
Importa le immagini dei veicoli, con conversione opzionale in WebP (richiede GD o Imagick) e un numero massimo configurabile di immagini per veicolo.
Rilevamento delle modifiche: un hash del contenuto e un hash delle immagini vengono memorizzati per ciascun veicolo, in modo da saltare gli annunci non modificati nelle esecuzioni successive.
Sincronizzazione completa opzionale: i veicoli che scompaiono dal feed remoto vengono eliminati localmente, inclusi i relativi allegati importati. Attivazione opzionale per sicurezza.
Importazioni complete manuali tramite il Batch-Wizard con dimensione del batch adattiva, avanzamento in tempo reale, tempo stimato (ETA) e controlli di pausa/ripresa/interruzione.

Vedi Motore di importazione e Riferimento dell'importatore di auto.

Automazione e pianificazione

Pianificatore WP-Cron integrato con intervalli orari, ogni 6 ore, due volte al giorno, giornalieri e personalizzati (minimo 15 minuti).
Endpoint REST cron protetto da token per l'attivazione del cron da sistemi esterni.
Limite di veicoli per esecuzione configurabile e modalità coda immagini per garantire la robustezza del cron su hosting condivisi.
Worker della coda immagini che elabora gli allegati in modo asincrono per prevenire i timeout di PHP.

Vedi Eventi cron e pianificatore e Configurazione del cron del server.

Modello dati del veicolo

Una riga per veicolo in una tabella as24_vehicles dedicata con colonne indicizzate per le query comuni.
15 tassonomie native di attributi dei veicoli WordPress (marca, modello, carrozzeria, stato, tipo di carburante, trasmissione, trazione, colore esterno/interno, classe di emissione, etichetta energetica, categoria del veicolo, disposizione dei cilindri, tipo di garanzia, dettagli della garanzia).
Le chiavi post meta per la retrocompatibilità rispecchiano i campi più utilizzati per garantire la compatibilità con i temi.
Un livello manual_overrides consente agli amministratori di bloccare i valori dei campi in modo che sopravvivano alle re-importazioni.

Vedi Schema del database, Custom Post Type e tassonomie e Modello dati.

Presentazione front-end

Modelli di archivio e di singolo veicolo inclusi, completi di galleria immagini, elenco equipaggiamenti, dettagli del veicolo, modulo di contatto e componenti aggiuntivi opzionali.
Layout Manager: configura i filtri di ricerca, le schede dell'archivio, i blocchi del singolo veicolo e il layout dei preferiti/confronto direttamente dall'amministrazione.
Percorsi di override del tema per archive-as24ci_car.php e single-as24ci_car.php.
Shortcode per l'archivio, il filtro di ricerca, la pagina di confronto, la pagina dei preferiti e le schede della sede/orari di apertura. Vedi Riferimento degli shortcode.
Flussi opzionali di Preferiti / Lista dei desideri (memoria locale del browser) e Confronto veicoli sul front-end, posizionando i relativi shortcode o layout.
Calcolatore di finanziamento opzionale nelle pagine di dettaglio del veicolo, con tasso predefinito, durata, anticipo e posizionamento configurabili (attivo dove abilitato in Design & Stili).
Generazione e download opzionali di schede tecniche PDF per singolo veicolo, dove il PDF Manager è configurato e la funzionalità è abilitata.
Schede opzionali per Sedi / orari di apertura per le sedi dei concessionari, dove l'area Sedi è popolata e il relativo shortcode è inserito.

Lead e modulo di contatto

Modulo di contatto integrato nelle pagine dei singoli veicoli, memorizzato come post as24ci_lead.
Campi visibili, casella di controllo del consenso, messaggi di successo e di errore configurabili.
Modelli email personalizzabili per la notifica al concessionario e la conferma al cliente.
Esportazione CSV dalla scheda di amministrazione Lead.

Vedi Archiviazione ed elaborazione dei lead e Riferimento dei lead.

Contatti di vendita (CMH Team)

Contatti di vendita della concessionaria gestiti dal plugin, mantenuti nel menu principale separato CMH Team. I membri del team non necessitano di un account di accesso WordPress.
Ciascun contatto memorizza un nome, una foto opzionale, un'email e un telefono, mostrati come scheda di contatto nelle pagine di dettaglio del veicolo.
I contatti possono essere assegnati per veicolo, per sede del concessionario/venditore o come impostazione predefinita globale, con scelte manuali preservate tra le re-importazioni e regole di assegnazione automatica opzionali.
Il contatto risolto viene utilizzato come destinatario preferito per i lead, con una copia opzionale all'email generale della concessionaria.

Vedi CMH Team e instradamento dei contatti.

Prenotazione Test Drive

Modulo opzionale di richiesta Test Drive nelle pagine di dettaglio del veicolo.
Giorni della settimana disponibili, fascia oraria giornaliera, durata dello slot e date di esclusione configurabili.
Le richieste di prenotazione vengono memorizzate come lead e inoltrate all'email del destinatario configurato.

Vedi Richieste di Test Drive.

Avvisi di ricerca (Smart Stock Alerts)

I visitatori possono iscriversi ai criteri di ricerca salvati e ricevere una notifica quando viene importato un veicolo corrispondente.
Flusso di Double-Opt-In conforme al GDPR: gli iscritti devono confermare tramite un link email prima che vengano inviate le notifiche.
Le notifiche vengono attivate automaticamente quando vengono importati veicoli corrispondenti.
Le iscrizioni sono memorizzate nella tabella dedicata as24ci_search_agents e gestite nella scheda di amministrazione Avvisi di ricerca.

Vedi Avvisi di ricerca front-end, Riferimento degli avvisi di ricerca e Double Opt-In degli avvisi di ricerca.

AI Assistant (opzionale)

Genera descrizioni dei veicoli, meta titoli e descrizioni SEO, testi alternativi delle immagini ed evidenziazioni dell'equipaggiamento.
Utilizza la configurazione gestita di Google Gemini in ADP Car Market Hub. Non è richiesta alcuna selezione del provider, del modello o l'inserimento di chiavi API nel backend WordPress; il provisioning dell'IA specifico per il cliente viene completato da AD Promotion dopo l'installazione.
Lingua, tono, lunghezza target e un modello di prompt personalizzato configurabili.
La coda in background elabora le attività dell'IA in modo asincrono tramite un intervallo WP-Cron personalizzato di 5 minuti.

Vedi Riferimento di AI Assistant e Note tecniche di AI Assistant.

Content Studio (opzionale)

Trasforma un veicolo già presente nell'inventario in testi di marketing pronti per essere pubblicati sui social media e altri canali: Facebook, Instagram, TikTok, Profilo dell'attività su Google, WhatsApp, newsletter della concessionaria e sito web.
La generazione può essere eseguita in una o più lingue contemporaneamente, con un tono predefinito configurabile, la voce del brand della concessionaria e linee guida obbligatorie di conformità/disclaimer.
La generazione del testo utilizza una chiave API di Google di proprietà della concessionaria e memorizzata in modo crittografato; il plugin produce testo (e, per alcuni formati, una bozza di immagine di marketing) da copiare e pubblicare manualmente e non pubblica mai sui social network per tuo conto.
Disponibile dove incluso nella licenza; legge solo i dati del veicolo e scrive esclusivamente nei propri record di Content Studio.

Vedi Riferimento di Content Studio.

Analytics

Tracciamento lato server di visualizzazioni di pagina, visualizzazioni di archivio/confronto/preferiti, ricerche con filtri, eventi di apertura dei contatti e invii di lead.
Grafici giornalieri e una classifica dei veicoli più visualizzati nella scheda di amministrazione Analytics.
Finestra di conservazione configurabile con un cron di pulizia giornaliero.
Consenso opzionale tramite il filtro as24ci_analytics_consent_check.

Vedi Tracciamento di Analytics e Conservazione dei dati di Analytics.

Market Insights (opzionale)

Visualizzazioni aggregate di analisi di mercato e valutazione dei prezzi per l'inventario locale, presentate tramite la pagina di amministrazione Market Insights.
Attivo dove configurato; a seconda della configurazione del plugin installato, alcuni pannelli potrebbero richiedere una fonte di dati gestita aggiuntiva fornita da AD Promotion.

EnVKV / Etichettatura energetica (opzionale)

Configurazione per l'ordinanza tedesca sulla divulgazione del consumo energetico (EnVKV / Pkw-EnVKV), inclusi i campi relativi a consumo, emissioni e classe energetica utilizzati sulle schede dell'archivio, sulle pagine di dettaglio del veicolo e sulla scheda tecnica PDF.
Attivo dove abilitato e configurato per i mercati pertinenti; può essere lasciato invariato sulle installazioni che non richiedono la conformità EnVKV.

Webhook (opzionale)

Eventi in uscita new_lead e new_import inviati a URL configurati dall'amministratore.
Firma HMAC-SHA256 opzionale per la verifica del destinatario.
Strategia di tentativi limitata per errori temporanei.

Vedi Webhook e Riferimento degli eventi webhook.

REST API (opzionale)

Endpoint pubblici di sola lettura GET /wp-json/as24ci/v1/vehicles e GET /wp-json/as24ci/v1/vehicles/{id} per consumatori esterni.
Un helper per i preferiti utilizzato dalla pagina dei preferiti del front-end.
Un endpoint di tracciamento analytics pubblico utilizzato dallo script del front-end.
Un endpoint GET /wp-json/as24ci/v1/cron-import protetto da token per pianificatori esterni.

Vedi Endpoint REST API e Riferimento degli endpoint REST.

Design e layout

Colori del brand, tipografia, badge, configurazione della galleria e CSS personalizzato tramite la scheda Design & Stili.
Layout Manager organizza i filtri di ricerca, le schede dell'archivio, i blocchi del singolo veicolo e i layout di confronto/preferiti senza codice.
La scheda di mappatura modifica le etichette e la visibilità di ogni campo importato.

Vedi Riferimento di Design & Stili, Riferimento di Layout Manager and Riferimento di Mappatura.

Operazioni e manutenzione

Registrazione dettagliata (logging) con rotazione automatica al limite di 10 MB.
Scheda Sistema & Aiuto con controlli dell'ambiente, stato del cron, stato della coda immagini, stato dei log, test di connessione ed esportazione della diagnostica.
Scheda Strumenti per la diagnostica del singolo post, simulazioni di importazione (dry-run) e importazione/esportazione delle impostazioni del plugin.

Vedi Operazioni e manutenzione.