La gerarchia dei template WordPress determina quale file PHP viene usato per renderizzare ogni pagina del tuo sito. Quando un visitatore richiede un URL, WordPress segue un ordine specifico di controlli sui file di template, partendo dal più specifico e ripiegando su template più generali. Comprendere questa gerarchia è essenziale per lo sviluppo di temi.
Questa guida analizza la gerarchia dei template di WordPress, mostrando esattamente quali template vengono controllati per ogni tipo di pagina.
La Home Page
La selezione del template della homepage dipende dalle tue impostazioni di lettura. Se la tua homepage mostra gli ultimi post, WordPress controlla front-page.php, poi home.php, poi index.php. Se la tua homepage usa una pagina statica, WordPress usa il template della pagina selezionata o front-page.php.
La maggior parte dei temi crea un front-page.php per la homepage e un home.php per la pagina indice degli articoli del blog. Se nessuno dei due esiste, index.php gestisce tutto.
Articoli singoli
I template dei singoli post seguono una gerarchia specifica. WordPress controlla prima single-post-{slug}.php (es. single-post-hello-world.php). Se non esiste, controlla single-post-{id}.php. Poi single.php, poi singular.php e infine index.php.
Per i custom post type, WordPress controlla single-{posttype}-{slug}.php, poi single-{posttype}.php, poi single.php, singular.php e index.php. Questo ti permette di creare template unici per ogni post type.
Pagine
Le pagine seguono una gerarchia simile ai post. WordPress controlla il template personalizzato della pagina (impostato nella meta box Attributi Pagina), poi page-{slug}.php, page-{id}.php, page.php, singular.php e index.php.
I template di pagina personalizzati vengono creati aggiungendo un commento di intestazione con il nome del template a un file PHP nella directory del tuo tema. Il template appare come opzione nella meta box Attributi pagina nelle schermate di modifica della pagina.
Pagine Archivio
Le pagine archivio mostrano elenchi di post. WordPress controlla archive.php per tutti gli archivi, poi template più specifici: category-{slug}.php e category-{id}.php per gli archivi di categoria, tag-{slug}.php e tag-{id}.php per gli archivi di tag, author-{nicename}.php e author-{id}.php per gli archivi autore, date.php per gli archivi basati sulla data e infine index.php se nessuno dei precedenti esiste.
Per gli archivi di tassonomie personalizzate, WordPress controlla taxonomy-{taxonomy}-{term}.php, poi taxonomy-{taxonomy}.php, poi archive.php e index.php.
I risultati di ricerca usano search.php se esiste, altrimenti index.php. Puoi personalizzare il template dei risultati di ricerca per mostrare suggerimenti di ricerca, evidenziare i termini corrispondenti o fornire filtri per i tipi di articolo.
I risultati di ricerca utilizzano search.php se esiste, altrimenti index.php. Puoi personalizzare il template dei risultati di ricerca per mostrare suggerimenti di ricerca, evidenziare i termini corrispondenti o fornire filtri per i tipi di post.
La pagina 404 usa 404.php se esiste, altrimenti index.php come fallback. Ogni tema dovrebbe includere un template 404.php che fornisca opzioni di navigazione utili — modulo di ricerca, articoli recenti, elenco di categorie — per aiutare i visitatori smarriti a trovare ciò che cercano.
I temi a blocchi usano un sistema di template diverso. I template sono file HTML nella directory /templates con markup a blocchi invece di PHP. La gerarchia funziona in modo simile: WordPress cerca prima il template più specifico, ripiegando su quelli più generali. I temi a blocchi hanno sostituito la gerarchia dei template PHP con un equivalente basato su blocchi che è ancora in sviluppo.
I temi a blocchi utilizzano un sistema di template diverso. I template sono file HTML nella directory /templates con markup a blocchi invece di PHP. La gerarchia funziona in modo simile: WordPress controlla prima il template più specifico, ripiegando su quelli più generali. I temi a blocchi hanno sostituito la gerarchia dei template PHP con un equivalente basato su blocchi che è ancora in fase di sviluppo.
Il punto fondamentale
La gerarchia dei template di WordPress è logica ed estensibile. I template specifici sovrascrivono quelli generali. Inizia con index.php come template generico, poi aggiungi template più specifici quando necessario. La gerarchia ti permette di creare design precisi per diversi tipi di contenuto mantenendo un fallback coerente per qualsiasi cosa non hai esplicitamente templato.
