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/locate template

Descrizione

Recupera il nome del file del template esistente con la priorità più alta.

Cerca STYLESHEETPATH prima di TEMPLATEPATH cosicché i temi che ereditano da un genitore possono sovrascrivere un file.

Utilizzo

<?php locate_template$template_names$load$require_once ?>

Parametri

$template_names
(array) (richiesto) Array di file di template da ricercare in ordine di priorità. (È richiesta l'estensione del file.)
Default: Nessuno
$load
(boolean) (opzionale) Se true il file del template verrà caricato se trovato.
Default: false
$require_once
(boolean) (opzionale) Se true il file del template verrà caricato con la funzione PHP require_once. Se false il file del template verrà caricato con la funzione PHP require. Questo parametro non ha effetto se $load è false.
Default: true

Valori restituiti

(string) 
Il nome del file del template se ne viene caricato uno, una stringa vuota altrimenti.

Esempi

if (locate_template('content-' . $pageName . '.php') != '') {
  // carica il template della pagina
  get_template_part('content', $pageName);
} else {
  // carica il contenuto
  the_content();
}

Note

Log delle modifiche

Da: 2.7.0

File sorgente

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

Correlati

Si veda anche l'indice di Riferimento funzioni e l'indice di Tag dei template.
This page is marked as incomplete. You can help Codex by expanding it.