WordPress.org (Italiano)

Come discusso, i file modello sono modulari, file riutilizzabili, utilizzati per generare le pagine web sul tuo sito WordPress. Alcuni file di modello (come il modello di intestazione e piè di pagina) vengono utilizzati su tutte le pagine del tuo sito, mentre altri vengono utilizzati solo in condizioni specifiche.

Questo articolo spiega come WordPress determina quali file modello(s) da utilizzare su singole pagine. Se vuoi personalizzare un tema WordPress esistente, ti aiuterà a decidere quale file modello deve essere modificato.,

La gerarchia dei file modello #La gerarchia dei file modello

Panoramica #Panoramica

WordPress utilizza la stringa di query per decidere quale modello o insieme di modelli deve essere utilizzato per visualizzare la pagina. La stringa di query è un’informazione contenuta nel collegamento a ciascuna parte del tuo sito web. Viene dopo il punto interrogativo iniziale e può contenere un numero di parametri separati da e commerciale.,

In parole povere, WordPress cerca attraverso la gerarchia del modello fino a trovare un file di modello corrispondente. Per determinare quale modello di file da utilizzare WordPress:

1. Corrisponde a ogni stringa di query per un tipo di query per decidere quale pagina richiesta (per esempio, una pagina di ricerca, una pagina di categoria, ecc);
2. Seleziona il modello in ordine determinato dal modello di gerarchia;
3. Guarda il modello di file con nomi specifici in tema di directory e utilizza il primo corrispondente file di modello, come specificato dalla gerarchia.,

Ad eccezione del file di modelloindex.php di base, è possibile scegliere se implementare o meno un particolare file di modello.

Se WordPress non riesce a trovare un file modello con un nome corrispondente, passerà al file successivo nella gerarchia. Se WordPress non riesce a trovare alcun file di modello corrispondente, verrà utilizzato il file index.php del tema.,

Top

Examples #Examples

Se il tuo blog si trova a e un visitatore fa clic su un link a una pagina di categoria come, WordPress cerca un file modello nella directory del tema corrente che corrisponda all’ID della categoria per generare la pagina corretta. Più specificamente, WordPress segue questa procedura:

1. Cerca un file modello nella directory del tema corrente che corrisponda allo slug della categoria. Se la categoria slug è “unicorni”, WordPress cerca un file modello denominato category-unicorns.php.,
2. Secategory-unicorns.php manca e l’ID della categoria è 4, WordPress cerca un file modello chiamatocategory-4.php.
3. Secategory-4.php manca, WordPress cercherà un file modello di categoria generico,category.php.
4. Secategory.php non esiste, WordPress cercherà un modello di archivio generico,archive.php.
5. Se manca anchearchive.php, WordPress tornerà al file modello del tema principale,index.php.,

Top

Panoramica visiva #Panoramica visiva

Il seguente diagramma mostra quali file di modello sono chiamati a generare una pagina WordPress in base alla gerarchia dei modelli di WordPress.

Top

La gerarchia del modello in dettaglio #La gerarchia del modello in dettaglio

Mentre la gerarchia del modello è più facile da capire come un diagramma, le sezioni seguenti descrivono l’ordine in cui i file del modello vengono chiamati da WordPress per un numero di tipi di query.

Top

Home Page display # Home Page display

Per impostazione predefinita, WordPress imposta la home page del tuo sito per visualizzare i tuoi ultimi post del blog. Questa pagina è chiamata l’indice dei post del blog. È inoltre possibile impostare i post del blog da visualizzare su una pagina statica separata., Il file modello home.php viene utilizzato per rendere l’indice dei post del blog, sia che venga utilizzato come prima pagina o su una pagina statica separata. Sehome.php non esiste, WordPress utilizzeràindex.php.

1. home.php
2. index.php

Top

Front Page display #Front Page display

Il file modello front-page.php viene utilizzato per rendere la prima pagina del tuo sito, sia che la prima pagina visualizzi l’indice dei post del blog (menzionato sopra) o una pagina statica. Il modello di prima pagina ha la precedenza sul modello di indice dei post del blog (home.php). Se il filefront-page.php non esiste, WordPress utilizzerà i filehome.php opage.php a seconda dell’impostazione in Impostazioni → Lettura., Se nessuno di questi file esiste, utilizzerà il fileindex.php.

1. front-page.php – Utilizzato sia per “i tuoi ultimi messaggi” o “una pagina statica”, come impostato nella prima pagina visualizza sezione di Impostazioni → Lettura.
2. home.php – Se WordPress non riesce a trovarefront-page.php e “i tuoi ultimi post” è impostato nella sezione display della prima pagina, cercheràhome.php. Inoltre, WordPress cercherà questo file quando la pagina post è impostata nella sezione display della prima pagina.,
3. page.php – Quando” front page ” è impostato nella sezione front page displays.
4. index.php – Quando “i tuoi ultimi post” è impostato nella sezione visualizza prima pagina mahome.php non esiste o quando la prima pagina è impostata mapage.php non esiste.

Come puoi vedere, ci sono molte regole su quale percorso prende WordPress. Utilizzando il grafico sopra è il modo migliore per determinare ciò che WordPress visualizzerà.,

Top

Visualizzazione pagina Informativa sulla privacy #Visualizzazione pagina Informativa sulla privacy

Il file modelloprivacy-policy.php viene utilizzato per visualizzare la pagina Informativa sulla privacy del tuo sito. Il modello di pagina dell’informativa sulla privacy ha la precedenza sul modello di pagina statica (page.php). Se il fileprivacy-policy.php non esiste, WordPress utilizzerà i filepage.php osingular.php a seconda dei modelli disponibili. Se nessuno di questi file esiste, utilizzerà il fileindex.php.,

1. privacy-policy.php – Utilizzato per la pagina Informativa sulla privacy impostata nella sezione Modifica la tua pagina Informativa sulla privacy di Impostazioni → Privacy.
2. custom template file – Il modello di pagina assegnato alla pagina. Vedere get_page_templates().
3. page-{slug}.php – Se lo slug della pagina èprivacy, WordPress cercherà di usarepage-privacy.php.
4. page-{id}.php – Se l’ID della pagina è 6, WordPress cercherà di usarepage-6.php.,
5. page.php
6. singular.php
7. index.php

Top

Singolo Post #Singolo Post

Il post unico modello di file viene utilizzato per eseguire il rendering di un singolo post. WordPress utilizza il seguente percorso:

Top

Single Page #Single Page

Il file modello utilizzato per il rendering di una pagina statica (page post-type).,es, page è speciale per WordPress e utilizza il seguente percorso:

Top

Category #Categoria

Rendering categoria archivio di pagine di indice utilizza il seguente percorso in WordPress:

Top

il Tag #Tag

Per visualizzare un tag archivio indice pagina, WordPress utilizza il seguente percorso:

Top

Custom Taxonomies #Custom Taxonomies

Custom taxonomies leggermente diverso percorso del file di modello:

Top

Tipi di messaggi Personalizzati #Tipi di messaggi Personalizzati

i Tipi di messaggi Personalizzati utilizzare il seguente percorso per rendere l’appropriato archivio pagina di indice.,

1. archive-{post_type}.php – Se il tipo di post èproduct, WordPress cercheràarchive-product.php.
2. archive.php
3. index.php

(Per il rendering di un modello di tipo post singolo, fare riferimento alla sezione Visualizzazione post singolo sopra.,s seguire lo stesso modello, come altri tipi di modello:

1. search.php
2. index.php

Top

errore 404 (Non Trovato) #404 (Non Trovato)

allo stesso modo, 404 file di modello sono chiamati in questo ordine:

1. 404.php
2. index.php

Top

Allegato n. Allegato

eseguire il Rendering di una pagina dell’allegato (attachment post-type) utilizza il seguente percorso:

Top

Incorpora #Incorpora

incorporare Il file di modello è utilizzato per eseguire il rendering di un post che è incorporato., Dal 4.5, WordPress utilizza il seguente percorso:

1. embed-{post-type}-{post_format}.php – Innanzitutto, WordPress cerca un modello per il post specifico. Ad esempio, se il suo tipo di post è post e ha il formato audio, WordPress cercherà embed-post-audio.php.
2. embed-{post-type}.php – Se il tipo di post èproduct, WordPress cercheràembed-product.php.
3. embed.php – WordPress ricade quindi per incorporare.php.,
4. Infine, WordPress alla fine ricade sul proprio modellowp-includes/theme-compat/embed.php.

Top

Non-ASCII Character Handling #Non-ASCII Character Handling

Da WordPress 4.7, qualsiasi parte dinamica di un nome modello che include caratteri non ASCII nel suo nome supporta effettivamente sia la forma non codificata che quella codificata, in questo ordine. È possibile scegliere quale utilizzare.,

Ecco il modello di pagina gerarchia per una pagina denominata “Hello World 😀” con ID 6:

• page-hello-world-😀.php
• page-hello-world-%f0%9f%98%80.php
• page-6.php
• page.php
• singular.php

La stessa cosa vale per post lumache, termine di nomi, e autore nicenames.

Top

Filter Hierarchy #Filter Hierarchy

Il sistema di template WordPress consente di filtrare la gerarchia., Ciò significa che è possibile inserire e modificare le cose in punti specifici della gerarchia. Il filtro (che si trova nella funzione get_query_template()) utilizza questo nome di filtro: "{$type}_template" dove $type è il tipo di modello.,category_template

Top

Example #Example

For example, let’s take the default author hierarchy:

• author-{nicename}.php
• author-{id}.php
• author.php

To add author-{role}.php before author.php, we can manipulate the actual hierarchy using the ‘author_template’ template type., Ciò consente una richiesta per / author / username in cui username ha il ruolo di editor da visualizzare utilizzando author-editor.php se presente nella directory temi corrente.