locate_template() 用来检索存在的优先级最高的模板文件，还能直接加载模板文件。

locate_template() 函数检索时，如果有子主题则优先使用子主题的模板，没有再继续检索父主题。

用法

1

locate_template($template_names,$load,$require_once);

参数

$template_names

（数组）（必须）要引入的模板文件名（需要扩展名），会根据数组逐个匹配文件是否存在，越前边的优先级越高。

默认值：None

$load

（布尔）（可选）如果设置成 True 则直接引入模板文件。

默认值：False

$require_once

（布尔）（可选）如果设置成 True 则如果之前引入过这次不再引入（require_once），否则无论是否引入过都会引入（require）。

（只有 $load 为 True，此参数才生效）。

默认值：False

返回值

（字符串）只要有一个指定的模板文件存在则返回它的路径，否则返回空字符串。

例子

if(locate_template(‘content-‘.$pageName.‘.php’)!==”){

    //存在，引入模板文件

    get_template_part(‘content’,$pageName);

}else{

    //不存在，直接显示内容

    the_content();

}

其它

此函数位于：wp-includes/template.php