FAQ per gli sviluppatori

Questa pagina raccoglie le domande frequenti orientate all'integrazione. Intenzionalmente non elenca nomi di classi interne, nomi di tabelle, chiavi di opzione, nomi di hook, rotte REST, identificatori di capability o dettagli della pipeline di rilascio — questi sono dettagli di implementazione interna.

Generale

Cos'è questo plugin?

ADP Car Market Hub è un plugin WordPress che importa e sincronizza gli annunci di veicoli da un marketplace a monte in WordPress ed espone un catalogo front-end (archivio, singolo veicolo, confronto, preferiti, filtro di ricerca) oltre a un'area amministrativa per la configurazione, le importazioni e la gestione dei lead.

Quali sono i requisiti di versione?

Le versioni richieste di WordPress e PHP per il plugin sono dichiarate nell'intestazione del plugin e nel file composer.json del progetto. Controlla questi valori per le versioni minime attualmente supportate.

Dove memorizza i suoi dati il plugin?

Gli annunci dei veicoli e i lead utilizzano l'archiviazione dei contenuti standard di WordPress. La configurazione utilizza le opzioni di WordPress. Il plugin gestisce anche un'archiviazione specifica del plugin dove richiesto per le proprie funzionalità. L'accesso diretto al database per l'archiviazione gestita dal plugin non è supportato.

Il plugin ha dipendenze a runtime?

Non sono richieste dipendenze a runtime aggiuntive oltre a WordPress e PHP nelle versioni minime documentate. Non è presente alcuna fase di compilazione JavaScript nel pacchetto rilasciato.

Integrazione

Come posso incorporare il catalogo in una pagina?

Utilizza gli shortcode documentati.

Come posso modificare l'aspetto di una pagina veicolo?

Sovrascrivi i template inclusi a partire dal tuo tema. Vedi Sistema di template e sovrascritture.

Come posso inoltrare i lead al mio CRM?

Utilizza la configurazione dei webhook in uscita del plugin nell'interfaccia utente di amministrazione anziché agganciarti a eventi interni. Verifica il webhook configurato rispetto alla versione corrente del plugin quando lo colleghi.

Come posso attivare le importazioni da un pianificatore esterno?

Configura l'automazione del plugin dall'interfaccia utente di amministrazione; essa include la superficie supportata e documentata per questo caso. Non dipendere da nomi di hook interni o endpoint non documentati.

Posso leggere i dati di analytics del plugin o di Market Insights dall'esterno del plugin?

No. I report sono esposti tramite l'interfaccia utente di amministrazione del plugin; l'archiviazione interna e gli endpoint non costituiscono un contratto pubblico.

Supporto

Come posso segnalare un bug?

Utilizza il canale di contribuzione del progetto descritto nelle Linee guida per la contribuzione. Per le informazioni sull'ambiente, preferisci l'esportazione della diagnostica disponibile dall'interfaccia utente di amministrazione del plugin piuttosto che copiare i file di log grezzi.

Superfici di integrazione pubbliche supportate

Quando ti integri con il plugin, preferisci queste superfici stabili:

• L'interfaccia utente delle impostazioni di amministrazione del plugin.
• Gli shortcode documentati.
• Le sovrascritture dei template a livello di tema come descritto in Sistema di template e sovrascritture.
• La Panoramica per gli sviluppatori generale per l'orientamento.

I nomi delle classi interne, le chiavi delle opzioni, le tabelle del database, gli endpoint REST e AJAX, i nomi degli hook cron, gli identificatori di capability e nonce, e l'infrastruttura di rilascio / aggiornamento sono trattati come dettagli di implementazione. Possono cambiare tra le versioni senza preavviso e non fanno parte del contratto di integrazione pubblico.

Politica di stabilità e modifiche

Tutto ciò che non è elencato come superficie pubblica supportata sopra è considerato un dettaglio di implementazione interna. Le API interne, il layout di archiviazione e l'implementazione della sicurezza possono cambiare tra le versioni. Non dipendere da essi da codice di terze parti, temi o sistemi esterni. Le scritture dirette nel database non sono supportate.

Avviso sulla documentazione pubblica. Questa pagina fornisce solo una panoramica di integrazione di alto livello. I dettagli di implementazione interna, le API private, i dettagli interni di archiviazione e l'infrastruttura di rilascio sensibile alla sicurezza sono mantenuti separatamente e non fanno parte della documentazione pubblica. Le superfici di integrazione supportate sono gli shortcode documentati, le sovrascritture dei template, l'interfaccia utente delle impostazioni e qualsiasi punto di estensione esplicitamente pubblicato in questa sezione.