Struttura della repository

Questa pagina fornisce un orientamento sicuro per il pubblico alla repository del plugin. Un inventario completo di file e classi, la mappa dei namespace e la descrizione modulo per modulo sono mantenuti come documentazione interna e non vengono pubblicati qui.

Orientamento

Al livello principale, la repository contiene il file PHP di ingresso principale del plugin, i suoi asset per l'amministrazione e i template, le traduzioni incluse, una directory tests/ utilizzata dalla continuous integration del progetto e il set di documentazione pubblica che stai attualmente leggendo in italiano sotto docs/.

Per i collaboratori che hanno bisogno di un ambiente di sviluppo funzionante, consultare la Configurazione dello sviluppo locale. Per le convenzioni di scrittura del codice, consultare gli Standard di codifica.

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 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 i rilasci senza preavviso e non fanno parte del contratto di integrazione pubblica.

Politica di stabilità e modifiche

Tutto ciò che non è elencato sopra come superficie pubblica supportata è considerato un dettaglio di implementazione interna. Le API interne, il layout di archiviazione e l'implementazione della sicurezza possono variare tra i rilasci. 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 i shortcode documentati, le sovrascritture dei template, l'interfaccia utente delle impostazioni e qualsiasi punto di estensione esplicitamente pubblicato in questa sezione.