WordPress.org

Ready to get started?Download WordPress

Codex

Attention Interested in functions, hooks, classes, or methods? Check out the new WordPress Code Reference!

it:Riferimento funzioni/load template

Descrizione

Richiede una volta il file del template con l'ambiente di WordPress.

Le variabili globali sono impostate per il file del template per garantire che l'ambiente di WordPress sia disponibile all'interno della funzione. Anche le variabili di query sono disponibili.

Utilizzo

<?php load_template$_template_file$require_once ?>

Parametri

$_template_file
(string) (richiesto) Percorso del file del template.
Default: Nessuno
$require_once
(bool) (opzionale) Indica se usare require_once o require.
Default: true

Valori restituiti

(void) 
Questa funzione non restituisce alcun valore.

Esempi

Caricare un template in un plugin, permettendo al tema e al tema figlio di sovrascrivere il template

 if ( $overridden_template = locate_template( 'some-template.php' ) ) {
   // locate_template() restituisce il percorso del file
   // se il tema figlio o quello genitore hanno sovrascritto il template
   load_template( $overridden_template );
 } else {
   // Se il tema figlio e quello genitore non hanno sovrascritto il template,
   // viene caricato il template dalla sottocartella 'templates' che si trova nella cartella in cui

// si trova questo file

   load_template( dirname( __FILE__ ) . '/templates/some-template.php' );
 }

Note

  • Utilizza la variabile globale: (object) $wp_query per estrarre extract() le variabili globali restituite dal metodo query_vars proteggendo i valori correnti in queste variabili globali:
    • (unknown type) $posts
    • (unknown type) $post
    • (boolean) $wp_did_header Restituisce true se l'header di WordPress è già stato caricato. Si veda il file /wp-blog-header.php per maggiori dettagli.
    • (boolean) $wp_did_template_redirect
    • (object) $wp_rewrite
    • (object) $wpdb
    • (string) $wp_version contiene il numero della versione installata di WordPress.
    • (string) $wp
    • (string) $id
    • (string) $comment
    • (string) $user_ID

Log delle modifiche

Da: 1.5.0

File sorgente

load_template() si trova in wp-includes/template.php.

Correlati

Template Functions: locate_template(), load_template(), get_template(), get_template_part(), get_template_directory(), get_template_directory_uri(), get_page_templates(), comments_template(), get_query_template(), is_page_template()

Si veda anche l'indice di Riferimento funzioni e l'indice di Tag dei template.