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