Se stai personalizzando un sito WordPress e vuoi modificare il tema senza perdere tutto al primo aggiornamento, creare un child theme WordPress è la soluzione professionale e sicura. In questa guida ti mostriamo passo passo come farlo da zero, con codice pronto da copiare e tutti gli accorgimenti per evitare gli errori più comuni.
Cos’è un Child Theme e perché ti serve davvero
Un child theme (tema figlio) è un tema che eredita funzionalità, stili e template da un altro tema, chiamato parent theme (tema genitore). In pratica, ti permette di personalizzare il tuo sito senza toccare i file originali del tema principale.
I vantaggi concreti
- Aggiornamenti sicuri: quando il tema parent viene aggiornato, le tue modifiche restano intatte.
- Modifiche isolate: tutto il codice personalizzato vive in una cartella separata.
- Reversibilità: se qualcosa va storto, basta riattivare il parent.
- Best practice: è il metodo ufficiale raccomandato da WordPress.org.
Quando NON ti serve un child theme
Se devi solo aggiungere un po’ di CSS, puoi usare Aspetto > Personalizza > CSS aggiuntivo. Se invece vuoi modificare template PHP, aggiungere funzioni o personalizzazioni complesse, allora il child theme è obbligatorio.
Struttura dei file di un Child Theme
Un child theme funzionante richiede come minimo due file all’interno di una cartella dedicata:
| File | Obbligatorio | Funzione |
|---|---|---|
| style.css | Sì | Header del tema e CSS personalizzato |
| functions.php | Sì | Enqueue degli stili e funzioni custom |
| screenshot.png | No | Anteprima nel pannello Temi (1200x900px) |
| template files | No | File come header.php, footer.php da sovrascrivere |
Come Creare un Child Theme WordPress: Procedura Passo Passo
1. Crea la cartella del child theme
Accedi al tuo sito tramite FTP (o dal File Manager del tuo hosting) e naviga fino a /wp-content/themes/. Crea una nuova cartella con un nome significativo. La convenzione è aggiungere -child al nome del parent.
Esempio: se usi il tema Astra, chiama la cartella astra-child.
2. Crea il file style.css con l’header corretto
All’interno della cartella, crea un file chiamato style.css e incolla questo codice (modificandolo con i tuoi dati):
/*
Theme Name: Astra Child
Theme URI: https://mumblestudio.it/astra-child
Description: Child theme di Astra realizzato da Mumble Studio
Author: Mumble Studio
Author URI: https://mumblestudio.it
Template: astra
Version: 1.0.0
License: GNU General Public License v2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html
Text Domain: astra-child
*/
Attenzione: il campo Template è il più importante. Deve contenere esattamente il nome della cartella del tema parent (case sensitive). Se sbagli questo valore, WordPress restituirà un errore.
3. Crea il file functions.php per l’enqueue degli stili
Nella stessa cartella, crea il file functions.php e inserisci questo codice:
<?php
/**
* Enqueue degli stili del tema parent e child
*/
function mumble_child_enqueue_styles() {
// Carica lo stile del tema parent
wp_enqueue_style(
'parent-style',
get_template_directory_uri() . '/style.css'
);
// Carica lo stile del child theme
wp_enqueue_style(
'child-style',
get_stylesheet_directory_uri() . '/style.css',
array( 'parent-style' ),
wp_get_theme()->get( 'Version' )
);
}
add_action( 'wp_enqueue_scripts', 'mumble_child_enqueue_styles' );
Questo codice fa due cose fondamentali:
- Carica il foglio di stile del parent tramite
get_template_directory_uri(). - Carica il foglio di stile del child dichiarandolo come dipendente dal parent, così sovrascriverà correttamente le regole.
Nota importante: il vecchio metodo con @import dentro style.css è deprecato e penalizza le performance. Usa sempre wp_enqueue_style.
4. Aggiungi uno screenshot (opzionale ma consigliato)
Crea un’immagine 1200×900 pixel chiamata screenshot.png e mettila nella cartella del child theme. Apparirà nella sezione Aspetto > Temi.
5. Attiva il child theme
Vai in Aspetto > Temi dalla bacheca di WordPress. Troverai elencato il tuo nuovo child theme. Cliccaci sopra e premi Attiva.
Apri il sito in incognito per verificare che tutto sia visualizzato correttamente.
Come Modificare i Template del Parent Theme
Una volta attivato il child, puoi sovrascrivere qualsiasi file template del parent semplicemente copiandolo nella cartella del child mantenendo lo stesso nome.
Esempio pratico: vuoi modificare il footer? Copia footer.php dal parent al child e modificalo lì. WordPress caricherà automaticamente la tua versione.
Eccezione: la cartella /inc/
I file dentro sottocartelle come /inc/ o /template-parts/ non vengono sovrascritti automaticamente: vanno richiamati esplicitamente nel functions.php del child con require_once.
Errori Comuni da Evitare
- Sbagliare il valore Template: deve corrispondere al nome esatto della cartella del parent, non al suo “Theme Name”.
- Dimenticare il tag PHP di apertura: il file
functions.phpdeve iniziare con<?phpsenza spazi prima. - Usare @import: deprecato, rallenta il caricamento del sito.
- Non testare prima della messa online: prova sempre il child theme in ambiente di staging.
- Disinstallare il parent theme: il child non funzionerà mai senza il parent installato (anche non attivo).
- Modificare i file del parent comunque: vanifica tutto il senso del child theme.
Alternativa: Creare un Child Theme con un Plugin
Se non te la senti di mettere mano al codice, esistono plugin come Child Theme Configurator o Generate Child Theme che automatizzano il processo. Il nostro consiglio comunque è di imparare il metodo manuale: ti darà controllo totale e nessuna dipendenza da plugin esterni.
Considerazioni Finali
Creare un child theme WordPress richiede meno di 10 minuti se segui i passaggi corretti. È un investimento minimo che ti salverà ore di lavoro quando arriveranno gli aggiornamenti del tema parent.
Se hai bisogno di supporto per personalizzazioni avanzate del tuo sito WordPress, in Mumble Studio ci occupiamo quotidianamente di sviluppo custom su misura per le esigenze dei nostri clienti.
FAQ sul Child Theme WordPress
Posso creare un child theme di un child theme?
No, WordPress non supporta nativamente questa funzionalità. Un child theme deve sempre fare riferimento a un parent theme “vero”.
Il child theme funziona con qualsiasi tema?
Sì, qualsiasi tema WordPress ben sviluppato supporta i child theme. I temi più popolari come Astra, GeneratePress, OceanWP e Kadence sono perfettamente compatibili.
Cosa succede se elimino il parent theme?
Il child theme smetterà di funzionare immediatamente, perché eredita tutti i file e le funzioni dal parent. Il parent deve essere sempre presente nella cartella themes, anche se non è il tema attivo.
Posso usare un child theme con i Block Theme di WordPress?
Sì, anche i temi a blocchi (FSE) supportano i child theme. La logica è la stessa, ma puoi anche sovrascrivere i template HTML e le parti di template del parent.
Devo aggiornare anche il child theme?
Generalmente no: gli aggiornamenti riguardano il parent theme. Aggiornerai il tuo child theme solo quando vorrai aggiungere nuove personalizzazioni o adeguarti a cambiamenti importanti del parent.
Quanto costa far creare un child theme da un’agenzia?
La sola creazione del child theme è un’operazione veloce. Il costo reale dipende dalle personalizzazioni che vuoi implementare al suo interno: un’agenzia come Mumble Studio può fornirti un preventivo basato sulle tue esigenze specifiche.