Documentazione · Panoramica
Panoramica del prodotto
Questo documento introduce il plugin ADP Car Market Hub WordPress: cosa fa, a chi si rivolge e come si integra nel tipico sito web di un concessionario.
Quando utilizzare questo documento
Leggi questo documento quando valuti il plugin per la prima volta, quando hai bisogno di un breve riepilogo da condividere con un collega o uno stakeholder, o quando desideri confermare se un particolare caso d'uso rientra nell'ambito del plugin prima di leggere le sezioni dettagliate.
Panoramica
ADP Car Market Hub collega un sito WordPress all'API ufficiale di AutoScout24 e trasforma il suo inventario di veicoli in contenuti nativi di WordPress. Gli annunci importati vengono memorizzati come un custom post type (as24ci_car), arricchiti con tassonomie di attributi del veicolo ed esposti attraverso i template, gli shortcode e gli strumenti di amministrazione del plugin.
Il plugin è progettato per i concessionari di auto e i gruppi di concessionari che dispongono già dell'accesso all'API di AutoScout24. Non effettua lo scraping del sito web pubblico di AutoScout24. Tutti i dati dei veicoli vengono recuperati tramite l'endpoint API configurato con le credenziali fornite dal tuo provider.
Funzionalità principali:
- Importazione e sincronizzazione di annunci di veicoli, immagini, equipaggiamenti e prezzi dall'API configurata.
- Pianificazione di importazioni ricorrenti tramite WP-Cron o un cron di sistema esterno con un trigger REST protetto da token.
- Gestione dei veicoli nell'amministrazione di WordPress e presentazione sul front-end tramite i template inclusi per archivio, pagina singola, confronto e preferiti.
- Acquisizione di lead da moduli di contatto e richieste di test drive con instradamento all'indirizzo del destinatario configurato.
- Gestione dei contatti di vendita della concessionaria gestiti dal plugin (CMH Team) mostrati sulle pagine dei veicoli e utilizzati per instradare i lead.
- Add-on opzionali per descrizioni generate dall'IA, testi di marketing Content Studio, avvisi di ricerca (Smart Stock Alerts), Analytics, un calcolatore di finanziamento, un PDF datasheet, sedi, Market Insights e altro ancora.
Destinatari
- Personale e redattori del concessionario — gestiscono l'inventario, i lead e la presentazione front-end tramite l'amministrazione di WordPress.
- Amministratori del sito — installano, configurano e gestiscono il plugin, incluse credenziali, cron e integrazioni.
- Sviluppatori e integratori — estendono il plugin, creano integrazioni personalizzate o sovrascritture di temi.
Collocazione nella documentazione
La documentazione in italiano è suddivisa nelle seguenti sezioni principali:
- Iniziare — installazione e prima connessione.
- Requisiti di sistema — prerequisiti di hosting, PHP e rete.
- Manuale utente — flussi di lavoro editoriali quotidiani.
- Riferimento amministratore — spiegazione di ogni schermata di amministrazione.
- Documentazione tecnica — architettura, modello dei dati e comportamento interno.
- Guida all'integrazione — credenziali, cron del server, temi e page builder.
- Guida al frontend — cosa vedono i visitatori e come è composto.
- Operazioni e manutenzione — gestione del plugin in produzione.
- Privacy, sicurezza e conformità — gestione dei dati, consenso e controllo degli accessi.
- Risoluzione dei problemi — ricette basate sui problemi.
- Note di rilascio — modifiche suddivise per versione.
- Appendici — riferimenti rapidi per shortcode, impostazioni, hook ed endpoint.
- Documentazione per sviluppatori — punti di estensione per codice personalizzato.
Fuori ambito
- Scraping di pagine HTML da AutoScout24 o da terze parti.
- Fungere da sostituto per un contratto di concessionario o per l'accesso alle API di AutoScout24.
- Hosting del sito WordPress stesso; il plugin viene eseguito all'interno di un'installazione WordPress gestita dal cliente.
Note operative
- Il plugin utilizza la tabella delle opzioni di WordPress per memorizzare la sua configurazione. I segreti sensibili sono protetti a riposo: il client secret dell'API di AutoScout24 è memorizzato utilizzando la crittografia autenticata AES-256-GCM (con la chiave derivata dai salt di WordPress), e il token di importazione cron è memorizzato come hash HMAC-SHA256 unidirezionale. Il token cron in chiaro viene visualizzato nell'amministrazione solo per una breve finestra temporale dopo la generazione. I backup del database devono comunque essere trattati come sensibili, poiché contengono anche lead, impostazioni e altri dati operativi.
- Le funzionalità opzionali come l'AI Assistant, i Webhook, gli avvisi di ricerca e l'API REST pubblica sono disabilitate finché un amministratore non le attiva.
- Le etichette di amministrazione localizzate e i file di traduzione sono forniti con il plugin. La documentazione in inglese è la lingua sorgente e potrebbe utilizzare formulazioni prudenti laddove il comportamento dipende dalla configurazione del cliente. Verifica qualsiasi comportamento che intendi pubblicare per i clienti rispetto alla versione corrente del plugin.