WordPress.org (Italiano)

I modelli di pagina sono un tipo specifico di file modello che può essere applicato a una pagina oa gruppi di pagine specifici.

Poiché un modello di pagina è un tipo specifico di file modello, ecco alcune caratteristiche distintive dei modelli di pagina:

• I modelli di pagina vengono utilizzati per modificare laspetto di una pagina.
• Un modello di pagina può essere applicato a una singola pagina, una sezione di pagina o una classe di pagine .
• I modelli di pagina generalmente hanno un alto livello di specificità e hanno come target una singola pagina o un gruppo di pagine. Ad esempio, un modello di pagina denominato page-about.php è più specifico dei file modello page.php o index.php poiché interesserà solo una pagina con lo slug “about”.
• Se un modello di pagina ha un nome di modello, gli utenti di WordPress che modificano la pagina hanno il controllo su quale modello verrà utilizzato per il rendering della pagina.

Usi per modelli di pagina #Uses per modelli di pagina

I modelli di pagina mostrano il contenuto dinamico del tuo sito su una pagina, ad esempio post, aggiornamenti di notizie, eventi di calendario, file multimediali , ecc. Potresti decidere di volere che la tua home page abbia un aspetto specifico, che è abbastanza diverso da altre parti del tuo sito. Oppure, potresti voler visualizzare unimmagine in primo piano che si collega a un post su una parte della pagina, avere un elenco degli ultimi post altrove e utilizzare una navigazione personalizzata. Puoi utilizzare modelli di pagina per ottenere questi risultati.

Questa sezione mostra come creare modelli di pagina che possono essere selezionati dai tuoi utenti attraverso i loro schermate di amministrazione.

Ad esempio, puoi creare modelli di pagina per:

• a larghezza intera, una colonna
• due colonne con una barra laterale a destra
• due colonne con una barra laterale a sinistra
• tre colonne

In alto

Modelli di pagina allinterno della gerarchia dei modelli #Page Modelli allinterno della gerarchia dei modelli

Quando una persona accede al tuo sito Web, WordPress seleziona quale modello utilizzare per visualizzare quella pagina. Come abbiamo appreso in precedenza nella Gerarchia dei modelli, WordPress cerca i file dei modelli nel seguente ordine:

1. Modello di pagina: se alla pagina è assegnato un modello personalizzato, WordPress cerca quel file e, se trovato , lo utilizza.
2. page-{slug}.php – Se non è stato assegnato alcun modello personalizzato, WordPress cerca e utilizza un modello specializzato che contiene lo slug della pagina.
3. page-{id}.php – Se non viene trovato un modello specializzato che include lo slug della pagina, WordPress cerca e utilizza un modello specializzato denominato con lID della pagina.
4. page.php – Se un modello specializzato che include lID della pagina non viene trovato, WordPress cerca e utilizza il modello di pagina predefinito del tema.
5. singular.php – Se page.php non viene trovato, WordPress cerca e utilizza il modello del tema utilizzato per un singolo post, indipendentemente dal tipo di post.
6. index.php – Se non specifico vengono assegnati o trovati modelli di pagina, WordPress torna a utilizzare il file di indice del tema per il rendering delle pagine.

Inizio

Modelli di pagina Scopo & Controllo utente #Page Templates Scopo & Controllo utente

Se prevedi di creare un modello di pagina personalizzato per il tuo tema, dovresti decidere un paio di cose prima di procedere:

• Se il modello di pagina sarà per una pagina specifica o per qualsiasi pagina; e
• Che tipo di controllo utente desideri sia disponibile per il modello.

Ogni modello di pagina che ha un nome di modello può essere selezionato da un utente quando crea o modifica una pagina. Lelenco dei modelli disponibili è disponibile in Pages > Aggiungi nuovi > Attributi > Modello . Pertanto, un utente WordPress può scegliere qualsiasi modello di pagina con un nome di modello, che potrebbe non essere la tua intenzione.

Ad esempio, se desideri avere un modello specifico per la tua pagina “Informazioni”, potrebbe non essere appropriato chiamare quel modello di pagina “Informazioni sul modello” in quanto sarebbe globalmente disponibile a tutte le pagine (cioè lutente potrebbe applicarlo a qualsiasi pagina). Invece, crea un modello monouso e WordPress renderà la pagina con il modello appropriato, ogni volta che un utente visita la pagina “Informazioni”.

Al contrario, molti temi includono la possibilità di scegliere il numero di colonne in una pagina Ciascuna di queste opzioni è un modello di pagina disponibile a livello globale.Per offrire ai tuoi utenti di WordPress questa opzione globale, dovrai creare modelli di pagina per ciascuna opzione e assegnare a ciascuno un nome di modello.

Stabilire se un modello è per uso globale o per uso singolo si ottiene a proposito il file ha un nome e se ha o meno un commento specifico.

Top

Organizzazione dei file dei modelli di pagina # Organizzazione dei file dei modelli di pagina

Come discusso in Organizzazione dei file dei temi, WordPress riconosce le sottocartelle dei modelli di pagina. Pertanto, è una buona idea memorizzare i modelli di pagina globali in questa cartella per mantenerli organizzati.

Inizio

Creazione di modelli di pagina personalizzati per uso globale #Creazione di modelli di pagina personalizzati per un uso globale

A volte vorrete un modello che possa essere usato globalmente da qualsiasi pagina o da più pagine. Alcuni sviluppatori raggrupperanno i loro modelli con un prefisso del nome del file, come page_two-columns.php

Per informazioni sulle convenzioni di denominazione dei file dei temi e sui nomi dei file che non è possibile utilizzare, vedere i nomi dei file dei temi riservati.

Per creare un modello globale, scrivi un commento PHP di apertura allinizio di il file che indica il nome del modello.

<?php /* Template Name: Example Template */ ?>

È una buona idea scegli un nome che descriva ciò che fa il modello poiché il nome è visibile agli utenti di WordPress quando modificano la pagina. Ad esempio, potresti nominare il tuo modello Homepage, Blog o Portfolio.

Questo esempio dal tema TwentyFourteen crea un modello di pagina chiamato Pagina a larghezza intera:

<?php/*** Template Name: Full Width Page** @package WordPress* @subpackage Twenty_Fourteen* @since Twenty Fourteen 1.0*/

Dopo aver caricato il file nella cartella del tema (ad es. page- modelli), vai alla pagina > Modifica schermata nella dashboard dellamministratore.

On the right hand side under attributes you"ll see template. This is where users are able to access your global page templates.

Tip: The select list has a maximum width of 250px, so longer names may be cut off.

Inizio

Creazione di un modello di pagina personalizzato per una pagina specifica #Creazione di un modello di pagina personalizzato per una pagina specifica

Come menzionato nella pagina Gerarchia dei modelli, puoi creare un modello per una pagina specifica. Per creare un modello per una pagina specifica, copia il file page.php esistente e rinominalo con lo slug o lID della pagina:

1. page-{slug}.php
2. page-{ID}.php

Ad esempio: la tua pagina Informazioni ha uno slug di” circa ” e un ID 6. Se la cartella del tema attivo ha un file denominato page-about.php o page-6.php, WordPress troverà e utilizzerà automaticamente quel file per visualizzare la pagina Informazioni.

Per essere utilizzati, i modelli di pagina specializzati devono trovarsi nella cartella del tema (ad esempio / wp-content / themes / my-theme-name /).

In alto

Creazione di modelli di pagina per tipi di post specifici #Creazione di modelli di pagina per tipi di post specifici

Per impostazione predefinita, un modello di pagina personalizzato sarà disponibile per il tipo di post “pagina”.

Per creare un modello di pagina per tipi di post specifici, aggiungi una riga sotto il nome del modello con i tipi di post che desideri che il modello supporti.

Esempio:

<?php/*Template Name: Full-width layoutTemplate Post Type: post, page, event*/// Page code here...

Quando esiste almeno un modello per un tipo di articolo, il meta box “Attributi del post” verrà visualizzato nel back-end, senza la necessità di aggiungere il supporto del tipo di post per “attributi di pagina” o qualsiasi altra cosa. Letichetta “Attributi del post” può essere personalizzata per tipo di post utilizzando letichetta “attributi” durante la registrazione di un tipo di post.

Compatibilità con le versioni precedenti:

Supponiamo che tu voglia pubblicare pubblicamente un tema con supporto per modelli di post type. Le versioni di WordPress precedenti alla 4.7 ignoreranno lintestazione del tipo di post del modello e mostreranno il modello nellelenco dei modelli di pagina, anche se funziona solo per i post normali.Per evitare ciò, puoi agganciarti al filtro theme_page_templates per escluderlo dallelenco. Ecco un esempio:

Espandi il codice sorgente completoComprimi il codice sorgente completo

In questo modo puoi supportare post personalizzati modelli di tipo in WordPress 4.7 e oltre mantenendo la piena compatibilità con le versioni precedenti.

Nota che theme_page_templates è in realtà un filtro _ {$ post_type} _templates di temi dinamici. La parte dinamica del nome dellhook, $ post_type, si riferisce al tipo di post supportato dai modelli. Per esempio. puoi collegarti a theme_product_templates per filtrare lelenco dei modelli per il tipo di articolo del prodotto.

Inizio

Utilizzo di tag condizionali nei modelli di pagina #Uso di tag condizionali nei modelli di pagina

Puoi apportare modifiche più piccole e specifiche della pagina con i tag condizionali nel file page.php del tuo tema. Ad esempio, il codice di esempio seguente carica il file header-home.php per la tua pagina principale, ma carica un altro file (header-about.php) per la tua pagina Informazioni, e quindi applica il valore predefinito header.php per tutte le altre pagine.

if ( is_front_page() ) :get_header( "home" );elseif ( is_page( "About" ) ) :get_header( "about" );else:get_header();endif;

Puoi trovare ulteriori informazioni sui tag condizionali qui.

Inizio

Identificazione di un modello di pagina #Identificazione di un modello di pagina

Se il tuo modello utilizza la funzione body_class(), WordPress stamperà le classi nel tag body per il nome della classe del tipo di post (page), lID della pagina (page-id-{ID}) e il modello di pagina utilizzato. Per limpostazione predefinita page.php, il nome della classe generato è page-template-default:

<body class="page page-id-6 page-template-default">

Quando si utilizza un modello di pagina personalizzato, la classe page-template lo farà print, insieme a una classe che nomina il modello specifico. Ad esempio, se il file del modello di pagina personalizzato è denominato come segue:

<?php/* Template Name: My Custom Page */?gt;

LHTML generato quindi sarà il seguente:

<body class="page page-id-6 page-template page-template-my-custom-page-php">

Notare il page-template-my-custom-page-php classe applicata al tag body.

In alto

Funzioni del modello di pagina #Funzioni dei modelli di pagina

Queste funzioni e metodi incorporati di WordPress possono aiutarti a lavorare con i modelli di pagina:

• get_page_template() restituisce il percorso del modello di pagina utilizzato per visualizzare la pagina.
• wp_get_theme()->get_page_templates() restituisce tutti i modelli di pagina personalizzati disponibili per il tema attualmente attivo (get_page_templates() è un metodo della WP_Theme class).
• is_page_template() restituisce true o false a seconda se è stato utilizzato un modello di pagina personalizzato per visualizzare la pagina.
• get_page_template_slug() r restituisce il valore del campo personalizzato _wp_page_template (null quando il valore è vuoto o “default”). Se a una pagina è stata assegnata una personalizzazione template, il nome file di quel modello viene memorizzato come valore di un campo personalizzato denominato "_wp_page_template" (nella tabella del database wp_postmeta). (I campi personalizzati che iniziano con un trattino basso non vengono visualizzati nel modulo dei campi personalizzati della schermata di modifica.)