Nei primi capitoli di questa guida si è più volte fatto riferimento alla gerarchia dei template. Si tratta della gerarchia in base alla quale WordPress individua il template con cui viene generata ogni singola pagina del sito. L'informazione relativa al tipo di pagina viene trasmessa tramite le querystring e la selezione del template avviene in base ai nomi dei file disponibili.
Tra tutti i template file, l'unico indispensabile è il file index.php, utilizzato da WordPress qualora manchino template più specifici per la pagina richiesta dall'utente.
La pagina iniziale
Per restituire la pagina iniziale di un sito Web basato su WordPress sono previsti due template: home.php e front-page.php. Il primo viene utilizzato quando la pagina iniziale mostra gli ultimi articoli del blog; il secondo quando viene impostata una pagina statica nel menu "Impostazioni lettura" del pannello di amministrazione.
In mancanza del file home.php, viene caricato il file index.php, in mancanza del file front-page.php, invece, WordPress cercherà il template page.php, nel caso in cui la pagina iniziale sia una pagina statica; in alternativa, qualora la pagina iniziale sia un elenco di articoli, WordPress cercherà di nuovo il template home.php.
Pagine singole
Per rendere singoli post e pagine statiche sono disponibili due template generali: single.php per gli articoli e page.php per le pagine statiche. Prima di questi due template, però, WordPress ne cercherà di più specifici. Quella che segue è la gerarchia prevista per articoli, tipi di post personalizzati e allegati:
Nel caso dei Post avremo:
single-post.phpsingle.php
Nel caso dei Custom post types avremo invece:
single-$posttype.phpsingle.php
Infine, nel caso degli allegati:
$mimetype.php$subtype.php$mimetype_$subtype.phpattachment.phpsingle.php
Le pagine statiche possono avere un template specifico per la singola pagina:
$custom.phppage.php
Oppure seguire lo schema della gerarchia:
page-$slug.phppage-$id.phppage.php
Come sempre, ogni qual volta manchino tutti i template della gerarchia, WordPress cercherà il file index.php.
Pagine di archivio
Una pagina di archivio è una pagina che ospita un elenco di notizie. Può trattarsi delle notizie di una specifica categoria, etichettate con un certo tag o con una determinata tassonomia, appartenenti ad un tipo di post personalizzato, create da un certo autore, o, infine, pubblicate in una certa data.
In tutti questi casi, WordPress cercherà template specifici per il tipo di archivio, secondo il seguente schema:
| Archivio | File di template |
|---|---|
| Categorie | category-$slug.phpcategory-$id.phpcategory.phparchive.php |
| Autore | author-$nicename.phpauthor-$id.phpauthor.phparchive.php |
| Post type (Tipo di post) |
archive-$posttype.phparchive.php |
| Tassonomia | taxonomy-$taxonomy-$term.phptaxonomy-$taxonomy.phptaxonomy.phparchive.php |
| Tag | tag-$slug.phptag-$id.phptag.phparchive.php |
| Data | date.phparchive.php |
Commenti, 404 e risultati di ricerca
Gli ultimi template generano il pop-up dei commenti (comments-popup.php), la pagina di errore 404 (404.php) e la pagina che mostra i risultati di una ricerca interna al sito (search.php).
Nell'immagine conclusiva di questo capitolo viene mostrata un'infografica dell'intera struttura gerarchica dei template.
Riferimenti online
Per ogni approfondimento degli argomenti trattati in questo capitolo, si rinvia alle seguenti risorse: