WordPress.org

Ready to get started?Download WordPress

Codex

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

es:Referencia de Funciones/locate template

This page is marked as incomplete. You can help Codex by expanding it.

Descripción

Recupera el nombre del fichero de plantilla de mayor prioridad que exista.

Busca por STYLESHEETPATH antes de TEMPLATEPATH para que los temas que hereden de un padre puedan sobrecargar un fichero.

Uso

<?php locate_template$nombres_de_plantilla$cargar$requerir_una_vez ?>

Parámetros

$nombres_de_plantillas
(array) (required) Array de ficheros de plantilla que se pueden buscar en orden de prioridad. (Necesita extensión de fichero.)
Default: None
$cargar
(boolean) (optional) Si cierto el fichero de plantilla se cargará si se encontrare.
Default: false
$requerir_una_vez
(boolean) (optional) Si cierto el fichero de plantilla se cargará con la función php require_once. Si falso el fichero de plantilla se cargará con la función php require. Este parámetro no tiene efecto si $cargar es falso.
Default: true

Valores de retorno

(string) 
El fichero de plantilla si se localizara, una cadena de texto vacía si no.

Ejemplos

if (locate_template('content-' . $nombrePagina . '.php') != '') {
	// Si, cargar la plantilla de página.
	get_template_part('content', $nombrePagina);
} else {
	// no, cargar el contenido.
	the_content();
}

Notas

Log de cambios

Desde: 2.7.0

Fichero fuente

locate_template() está ubicada en wp-includes/template.php.

Relacionado

Mira también el índice de referencia de funciones y el índice de etiquetas de plantilla.