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