# Struttura del progetto

File o Directory Contenuto Editabile
style.scss file principale del progetto No
_wp-style.scss intestazione del tema secondo standard WordPress Sì
_config.scss file di configurazione del progetto Sì
_custom.scss inclusione di tutti i file custom Sì
core/ parziali di default No
custom/ directory di tutti i file custom del progetto Sì
vendors/ librerie di terza parte Sì

# File principali

  • *style.scss è il file principale del tema, da questo file partono tutte le inclusioni del progetto. È bene non editare mai questo file.
  • _wp-style.scss contiene l'intestazione principale del tema necessaria a WordPress per caricare il tema child. Questo file è editabile. In questo file è possibile e corretto cambiare la versione del tema ogni volta che si rilascia una nuova release del progetto in esecuzione in modo da forzare il ricaricamento dei css e dei js del tema.
  • _config.php contiene le variabili di configurazione del tema.
  • _custom.php è l'entry-point di tutta la parte custom del progetto. È da questo file che partono tutte le inclusioni per la personalizzazione del tema child.

# La directory "core"

La directory core/ contiene i file principali del progetto. I file contenuti in questa directory non dovrebbero mai essere modificati né dovrebbero essere aggiunti nuovi contenuti.

È possibile non caricare questi file, o parti di essi semplicemente modificando il file config.scss

La maggior parte dello stile contenuto in questi file è modificabile attraverso l'override delle variabili, nel file custom/_variables.scss

# La directory "custom"

La directory custom/ è pensata per contenere tutto lo stile personalizzato necessario al progetto in fase di sviluppo.

I file che i programmatori avranno necessità di aggiungere, dovranno essere inclusi manualmente nel file _custom.scss

# La directory "vendors"

La directory vendors/ è pensata per contenere librerie esterne da includere nel progetto. Anche in questo caso, i file dovranno essere inclusi manualmentee nel progetto.

Per includere librerie esterne, sono disponibili due file 'vendors/vendors--high-priority' e 'vendors/vendors--low-priority.scss', che devono essere usati secondo il seguente criterio:

  • 'vendors/vendors--high-priority'
    deve contenere i file da includere prima di tutti quelli facenti parte del progetto Divi-Child, compresi i file contenuti in core/

  • 'vendors/vendors--low-priority'
    deve contenere i file da includere dopo i file facenti parte del progetto Divi-Child ma prima dei file contenuti in custom/

Pacchetti di update

I file vendors, per evitare sovrascritture di codice custom, non verranno ovviamente inclusi nei pacchetti di aggiornamento.

FontAwesome

La variabile di configurazione $font-awesome è stata rimossa in quanto le modalità di import (anche attraverso @use) non sono più permesse all'inerno di costrutti @if, pertanto, qualora voleste includere la libreria nel progetto, basterà decommentare le relative righe all'interno del file 'vendors/vendors--high-priority'