Registrazione e debug

Questa pagina descrive come il plugin gestisce la registrazione e il debug a livello generale. La classe interna del logger, la posizione del file di log, le soglie di rotazione e le regole di mascheramento sono dettagli di implementazione e non vengono pubblicati qui.

Comportamento ad alto livello

• Il plugin scrive la diagnostica di runtime in una propria destinazione di log gestita da WordPress, separata dal log di debug principale di WordPress.
• Il volume dei log è limitato: le vecchie voci vengono ruotate ed eliminate automaticamente.
• I valori sensibili (credenziali, token, intestazioni di autorizzazione, intestazioni di richieste firmate) vengono mascherati prima della scrittura di qualsiasi riga.
• Quando si verifica un errore durante un'importazione o un processo in background, il plugin mostra una notifica lato amministratore e scrive una voce diagnostica che può essere condivisa con il supporto.

Per gli amministratori

Se hai la necessità di condividere la diagnostica con il supporto, utilizza la funzione di esportazione della diagnostica disponibile dall'interfaccia utente amministrativa del plugin anziché copiare i file di log non elaborati. Il pacchetto esportato contiene le informazioni necessarie al supporto mantenendo i dati sensibili mascherati.

Per gli sviluppatori

Non fare affidamento su percorsi di file di log, formati o comportamenti di rotazione specifici da codice esterno; si tratta di dettagli di implementazione. Quando sviluppi con il plugin, preferisci il flusso di lavoro standard WP_DEBUG di WordPress insieme all'esportazione diagnostica del plugin.

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 Template System And Overrides.
• 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 pubblica.

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 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 ad 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 gli shortcode documentati, le sovrascritture dei template, l'interfaccia utente delle impostazioni e qualsiasi punto di estensione esplicitamente pubblicato in questa sezione.