# Linee Guida per lo sviluppo
Per ottenere uno sviluppo omogeneo tra i vari progetti e mettere ordine al caos (per quanto possibile), gli sviluppatori dovranno seguire attentamente e scrupolosamente le linee guida esposte in questa sezione.
# Configurazione
Il file include/config.php è il file di configurazione del tema. Prima di apportare modifiche al tema, assicuratevi di aver controllato tutte le impostazioni presenti in questo file.
TIP
Per conscere le possibilità offerte dal file di configurazione, vedi l'apposita sezione Config della documentazione
# Redirect dello staging
Per evitare danni SEO è possibile impostare un redirect verso il sito in produzione o altra destinazione tutto il WP di staging.
Per attivare questa funzione, utilizzare i relativi parametri di configurazione presenti nel file include/config.php
# PHP
Nel file funcion.php non dovrà mai essere scritto codice custom.
Alla prima riga del file troverete un include del file includes/functions_custom.php che sarà il file dal quale potrete iniziare a scrivere il vostro codice con i vostri eventuali include personali.
Prefissi delle funzioni
Le funzioni PHP devono avere tutte il prefisso diviChild__
# SCSS
La metodologia di lavoro per il file SCSS dovrà seguire questi semplici regole.
Tutto il codice custom dovrà essere inserito a partire dal file _custom.scss dove sarà possibile includere eventuali nuovi include.
Best Pratice
Sarebbe bene non inserire regole di stile nel file _custom.scss, ma utilizzarlo solo per includere nuovi file partials.
I partials custom dovranno essere inseriti all'interno della cartella custom/ dove troverete già dei file e delle nuove cartelle.
Per una più dettagliata documentazione sulla versione 5 si veda la sezione SCSS della documentazione.
# Solo per la versione 4
Nelle versioni 4, all'interno della directory custom/ sono presenti due file _custom_variables.scss e _custom_mixins.scss nei quali dovranno essere inseriti variabili e mixins custom relativi al progetto in sviluppo. Sempre all'interno della cartella custom/ sono presenti altri due file _DIVI-override.scss e _DIVI_mixins.scss (con alcune regole CSS già scritte) che dovranno contenere solo l'override dello stile base di DIVI, ovvero le classi completamente sovrascritte. Questi file possono essere modificati secondo le esigenze.
Per una più dettagliata documentazione sulla versione 4 si veda la sezione SCSS della documentazione.
# JAVASCRIPT
- Il file main-child-theme.js è il file principale del tema e non deve essere modificato.
- Il codice custom deve essere inserito nel file custom-child-theme.js che viene accorpato al main attraverso un task di Grunt già aggiunto anche al task watch.
- Eventuali altri file javascript possono essere inseriti nella cartella js/ ma dovranno essere manualmente aggiunti nell'apposito task nel file Gruntfile.js modificando anche il task watch se necessario.
Attenzione!
Questa documentazione della parte Javascript è relativa alla vecchia versione 4. Per il nuovo sistema basato sui moduli, si veda la sezione apposita della documentazione.
# Javascript Modules
È possibile caricare dei file JS come moduli, seguendo i principi di ES6, attraverso l'array di caricamento dei JS Custom presente nel file di configurazione.
# Caricamento Di File JS E CSS Aggiuntivi
Dalla versione 4.7 è possibile caricare ulteriori file js e css aggiuntivi (oltre a quelli ufficiali del tema child) semplicemente utilizzando i due array presenti nel file includes/config.php
Gli sviluppatori sono quindi tenuti, se non in casi particolari, a includere file utilizzando questa funzione.
I due array seguono in linea di massima la logica utilizzata dalle funzioni wp_enqueue_style e wp_enqueue_script. All'interno del file di config sono presenti degli esempi di utilizzo sotto forma di commento che possono essere seguiti con l'ausilio della documentazione ufficiale di WP. Di seguito i link:
wp_enqueue_style (opens new window) wp_enqueue_script (opens new window)