描述

检索存在的最高优先级模板文件的名称,可选地加载该文件。

在TEMPLATEPATH之前搜索STYLESHEETPATH,因此从父级继承的主题可以重载一个文件。

用法


<?php locate_template( $template_names, $load, $require_once ) ?>

参数

$template_names
(array)(必需)以优先顺序搜索的模板文件数组。(需要文件扩展名。)
默认值:无
$load
(boolean)(可选)如果为true,则会发现模板文件被加载。
默认值:false
$require_once
(boolean)(可选)如果为true,模板文件将加载php require_once函数。如果为false,模板文件将加载php require功能。如果$ load为false,则此参数不起作用。
默认值:true

返回值

(string)
模板文件名(如果位于),则为空字符串(如果没有)。

例子

根据当前的pagename加载一个特定的模板部分:


if (locate_template('content-' . $pageName . '.php') != '') {
	// yep,加载页面模板
       get_template_part('content', $pageName);
} else {
	// 
	不要加载内容the_content(); 
}