Accesso API
Configurate URL base dell'API, credenziali, accesso del venditore e verifiche di connessione necessarie per importare l'inventario veicoli.
Vedi la documentazione correlataINTEGRAZIONE TECNICA
Guida di integrazione per l'importazione API AutoScout24 su WordPress
Collegate ADP Car Market Hub con WordPress, accesso all'API AutoScout24, importazioni pianificate, webhook, template, page builder, traduzioni e flussi di presentazione frontend.
Panoramica della prontezza all'integrazione
Un'integrazione affidabile parte da un corretto accesso API, dalla configurazione del server, dall'elaborazione in background e dalla compatibilità frontend.
Elaborazione pianificata
Utilizzate un cron affidabile per importazioni ricorrenti, gestione delle immagini, job di pulizia e task in background.
Vedi la documentazione correlataCompatibilità con i temi
Validate pagine di archivio, pagine di dettaglio, shortcode e output dei template con il tema WordPress attivo.
Vedi la documentazione correlataFlusso di personalizzazione
Utilizzate template override, CSS personalizzato e integrazione con i page builder senza modificare i file core del plugin.
Vedi la documentazione correlataStaging e go-live
Testate l'integrazione in un ambiente controllato prima di trasferire configurazione e template in produzione.
Vedi la documentazione correlataArchitettura dell'integrazione
ADP Car Market Hub collega i dati esterni dei veicoli con WordPress, l'elaborazione pianificata e i layer di presentazione frontend.
| Layer | Componente | Ruolo nell'integrazione |
|---|---|---|
| Esterno | Sorgente dati esterna | Fornisce i dati dell'inventario veicoli tramite l'accesso API configurato. |
| Connessione | Credenziali API | Autorizzano il plugin a richiedere i dati dei veicoli per l'account configurato. |
| Configurazione | Impostazioni del plugin | Memorizzano valori di connessione, impostazioni di importazione, scelte di layout e preferenze operative. |
| Elaborazione | Motore di importazione | Elabora i dati dei veicoli, aggiorna l'inventario e coordina la sincronizzazione ricorrente. |
| Spazio di archiviazione | Database di WordPress | Memorizza record dei veicoli, metadati, impostazioni, log, lead e dati di analytics. |
| Media | Libreria media | Memorizza le immagini dei veicoli importate e i relativi asset multimediali. |
| Frontend | Template | Renderizzano pagine di archivio, pagine di dettaglio e altri moduli frontend. |
| Integrazione | Shortcode | Consentono un'integrazione frontend controllata in pagine, builder e layout personalizzati. |
| Presentazione | Pagine frontend | Presentano l'inventario importato ai visitatori del sito utilizzando il tema attivo. |
| Conversione | Lead e notifiche | Catturano le richieste e supportano i flussi di contatto con i clienti. |
| Intelligence | Analytics e Market Insights | Forniscono visibilità operativa e market intelligence dove configurati. |
Flusso di setup e connessione
Il processo di integrazione va completato in un ordine controllato, così i problemi di connessione vengono identificati prima dell'avvio delle importazioni in produzione.
- Preparate l'accesso API Raccogliete URL base dell'API, URL del token, identificatori del venditore e credenziali richieste prima di configurare il plugin.
- Configurate le impostazioni del plugin Inserite i valori di connessione nell'amministrazione di WordPress e tenete le credenziali fuori dalla documentazione pubblica e dai repository pubblici.
- Eseguite il test di connessione Validate che il server possa raggiungere gli endpoint API configurati e ricevere risposte valide.
- Eseguite un'importazione controllata Iniziate con un'importazione limitata per confermare dati dei veicoli, gestione dei media e comportamento degli aggiornamenti.
- Validate l'output frontend Esaminate pagine di archivio, pagine di dettaglio, shortcode, viste di confronto, preferiti e output dei template.
- Preparate il go-live Confermate cron, backup, migrazione da staging a live, pagine rilevanti per la SEO e controlli di supporto prima dell'uso in produzione.
Accesso API e credenziali esterne
La configurazione dell'API definisce come il plugin si connette ai dati esterni dei veicoli e autentica le richieste.
Valori di configurazione richiesti
- URL base dell'API
- URL del token
- Client ID
- Client Secret
- Seller ID o identificatore di account
- Endpoint del test di connessione, se configurato
- Ambiente API (staging o produzione)
Gestione delle credenziali
- Non pubblicate mai le credenziali nella documentazione
- Memorizzate le credenziali solo nelle impostazioni del plugin
- Limitate l'accesso agli amministratori autorizzati
- Validare gli URL API prima di importare
- Confermate i permessi dell'account prima del go-live
- Ruotare le credenziali quando cambiano gli accessi
Cron, automazione e webhook
Importazioni ricorrenti, routine di pulizia ed eventi di integrazione richiedono un'elaborazione in background affidabile.
Configurazione del cron lato server
Il cron lato server è consigliato per importazioni in produzione affidabili, processi di pulizia e task in background pianificati.
Configurazione del cron lato serverIntegrazione webhook
La documentazione dei webhook spiega come gestire eventi o segnali di integrazione esterna quando supportati.
Integrazione webhookAffidabilità dell'elaborazione in background
I job di importazione vanno monitorati così le chiamate API fallite, le code di immagini o i processi in ritardo possono essere identificati per tempo.
Cron ed elaborazione in backgroundIntegrazione di tema, template e page builder
Il plugin va integrato con il tema WordPress attivo senza modificare i file core del plugin.
Integrazione di tema e template
Output del tema
Utilizzate integrazione del tema e template override per controllare come pagine di archivio, pagine di dettaglio veicolo e moduli frontend vengono renderizzati.
- Template di archivio
- Template di dettaglio
- Override dei template
- Verifiche di compatibilità con il tema
- CSS personalizzato
- Validazione in staging
Integrazione con i page builder
Flussi di builder
Utilizzate flussi compatibili con i page builder dove supportati, mantenendo intatto l'output dell'inventario controllato dal plugin.
- Posizionamento degli shortcode
- Sezioni del builder
- Container di layout
- Blocchi di contenuto riutilizzabili
- Verifiche di responsività
- Validazione frontend
Output frontend e integrazione degli shortcode
L'output frontend va testato con dati reali dei veicoli, filtri configurati e tema attivo prima del go-live.
| Componente | Scopo | Documentazione |
|---|---|---|
| Archivio veicoli | Mostra l'inventario importato con filtri, ordinamento e card dei veicoli. | Archivio veicoli |
| Pagine di dettaglio veicolo | Mostra galleria, prezzi, specifiche, azioni di contatto e informazioni correlate al veicolo. | Pagine di dettaglio veicolo |
| Confronta | Permette ai visitatori di confrontare i veicoli selezionati. | Confronta |
| Preferiti | Permette ai visitatori di salvare i veicoli per consultarli in seguito. | Preferiti |
| Avvisi di ricerca | Supporta flussi di ricerca salvata o di avviso dove configurati. | Avvisi di ricerca |
| Shortcode | Permette un'integrazione controllata dell'output del plugin nelle pagine WordPress e nei layout dei builder. | Riferimento degli shortcode |
Traduzione e localizzazione
Plugin e documentazione sono predisposti per flussi multilingue. L'inglese rimane la lingua sorgente, mentre le cartelle tradotte utilizzano nomi di cartella e file localizzati.
Struttura della documentazione multilingue
- Lingua sorgente Inglese
- Cartelle di traduzione predisposte Tedesco · francese · italiano · spagnolo · olandese
- Nomenclatura delle cartelle Nomi di cartella e file localizzati per ciascuna lingua
- Mappa delle traduzioni translation-map.md collega i file localizzati alla sorgente inglese
- Stringhe del plugin Flussi di traduzione compatibili con Poedit
Flusso da staging a live
Un flusso controllato da staging a live riduce il rischio quando si trasferiscono configurazione API, template e output frontend in produzione.
- Ambiente di staging preparato
- Credenziali API verificate
- Test di connessione superato
- Importazione limitata testata
- Immagini dei veicoli verificate
- Pagina di archivio esaminata
- Pagine di dettaglio esaminate
- Shortcode esaminati
- Template override testati
- Strategia del cron confermata
- Backup disponibile
- Checklist per il go-live completata
Documentazione di integrazione
Aprite i documenti di integrazione rilevanti direttamente nel repository pubblico della documentazione.
| Documento | Link |
|---|---|
| Sezione della guida di integrazione | Sezione della guida di integrazione |
| Configurazione dell'API AutoScout24 | Configurazione dell'API AutoScout24 |
| Credenziali API esterne | Credenziali API esterne |
| Configurazione del cron lato server | Configurazione del cron lato server |
| Integrazione webhook | Integrazione webhook |
| Integrazione con il tema | Integrazione con il tema |
| Integrazione con i page builder | Integrazione con i page builder |
| Guida agli override dei template | Guida agli override dei template |
| Guida al CSS personalizzato | Guida al CSS personalizzato |
| Guida a traduzioni e Poedit | Guida a traduzioni e Poedit |
| Migrazione da staging a live | Migrazione da staging a live |
I link della documentazione seguono la lingua attiva del sito. L'inglese è la lingua sorgente. Le altre cartelle di lingua utilizzano nomi di cartella e file localizzati.