Documentazione · Documentazione per gli sviluppatori
Architettura del plugin per gli sviluppatori
Questa pagina fornisce una panoramica di alto livello orientata all'integrazione su come è organizzato il plugin. L'architettura interna dettagliata, il cablaggio delle classi, la sequenza di bootstrap, i collaboratori a lungo termine e gli identificatori di capability/option/cron sono gestiti separatamente e non fanno parte della documentazione pubblica.
Panoramica di alto livello
ADP Car Market Hub è un plugin WordPress autonomo che importa e sincronizza gli annunci di veicoli da un'API di marketplace a monte in WordPress. Registra un tipo di contenuto per i veicoli, espone un catalogo front-end (archivio, pagina singola, confronto, preferiti, filtro di ricerca) e fornisce un'area amministrativa per la configurazione, le importazioni e la gestione dei lead.
Il plugin segue le convenzioni standard dei plugin WordPress: si avvia da un singolo file PHP su plugins_loaded, distribuisce le traduzioni in /languages e fornisce percorsi puliti di attivazione, disattivazione e disinstallazione.
Su cosa dovrebbero fare affidamento gli integratori
- L'interfaccia utente delle impostazioni del plugin per tutta la configurazione.
- I shortcode pubblicati per incorporare i blocchi del catalogo, del confronto, del filtro di ricerca, dei preferiti e della posizione del venditore (vedi Shortcodes For Developers).
- Sovrascritture a livello di tema per i template front-end inclusi (vedi Template System And Overrides).
- Meccanismi di estensione standard di WordPress (filtri/azioni/REST/post-meta) solo nella misura documentata nelle pagine pubbliche dei punti di estensione di questa sezione.
Superfici di integrazione pubblica supportate
Quando ci si integra con il plugin, preferire queste superfici stabili:
- L'interfaccia utente delle impostazioni di amministrazione del plugin.
- I shortcodes documentati.
- Le sovrascritture dei template a livello di tema come descritto in Template System And Overrides.
- La Developer Overview 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 pubblica.
Politica di stabilità e modifica
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 variare 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 gestiti separatamente e non fanno parte della documentazione pubblica. Le superfici di integrazione supportate sono i shortcode documentati, le sovrascritture dei template, l'interfaccia utente delle impostazioni e qualsiasi punto di estensione esplicitamente pubblicato in questa sezione.