Configurazione dello sviluppo locale

Questa pagina descrive la struttura sicura per l'uso pubblico di un ambiente di sviluppo locale per il plugin. Le costanti esatte, i percorsi dei file, gli script di supporto interni e la configurazione dei servizi gestiti utilizzati dal setup di sviluppo di AD Promotion non sono pubblicati qui.

Quando utilizzare questo documento

Utilizza questo documento quando:

• Stai contribuendo con codice, template o documentazione al plugin da un fork.
• Hai la necessità di riprodurre un bug localmente prima di segnalarlo o risolverlo.
• Desideri valutare il comportamento del plugin rispetto a un'installazione WordPress controllata.

Gli utenti finali che installano il plugin su un sito di produzione devono invece seguire la Guida all'installazione del manuale utente.

Requisiti di alto livello

• Git per clonare il tuo fork del repository.
• PHP alla versione minima dichiarata nell'intestazione del plugin.
• Composer per installare le dipendenze di sviluppo (solo per il framework di test; il plugin non ha dipendenze Composer a runtime).
• Un'installazione locale di WordPress alla versione minima di WordPress dichiarata nell'intestazione del plugin. Qualsiasi strumento standard di sviluppo locale è supportato (Local, DDEV, Lando, wp-env, Docker, MAMP, LAMP/LEMP nativo, ecc.).

Flusso di lavoro tipico

1. Clona il tuo fork del repository.
2. Posiziona (o crea un collegamento simbolico per) la cartella del plugin all'interno di wp-content/plugins/ di un'installazione locale di WordPress che soddisfi le versioni minime documentate del plugin.
3. Attiva il plugin da wp-admin.
4. Installa le dipendenze di sviluppo con Composer se intendi eseguire la suite di test del progetto.
5. Esegui la suite di test dalla root del progetto seguendo la Guida ai test.
6. Apporta le tue modifiche seguendo gli Standard di codifica e le Linee guida per la contribuzione.

Note operative

• Non inviare mai segreti nei commit. Configura le credenziali API, i token di automazione o i segreti dei webhook tramite l'interfaccia utente di amministrazione del plugin sul tuo sito locale, non tramite file tracciati. Non inserire le credenziali in frammenti di codice wp-config.php tracciati dal controllo versione.
• Servizi gestiti. Alcune funzionalità del plugin si affidano a servizi gestiti da AD Promotion predisposti per i siti dei clienti. Per lo sviluppo locale di queste funzionalità, utilizza le tue credenziali di test personali configurate tramite l'interfaccia di amministrazione; la configurazione gestita di AD Promotion non viene distribuita.
• Diagnostica dettagliata. Quando hai bisogno di maggiori dettagli diagnostici a livello locale, abilita la registrazione dettagliata (verbose logging) dall'interfaccia di amministrazione del plugin anziché fare affidamento su percorsi di log interni.

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 di archiviazione interna e l'infrastruttura di rilascio sensibile per la sicurezza sono gestiti separatamente e non fanno parte della documentazione pubblica.