這篇文章主要介紹了WordPress中用于檢索模版的相關(guān)PHP函數(shù)使用解析,包括索模板的函數(shù)的使用,要的朋友可以參考下。

locate_template() 用來檢索存在的優(yōu)先級最高的模板文件，還能直接加載模板文件。

locate_template() 函數(shù)檢索時，如果有子主題則優(yōu)先使用子主題的模板，沒有再繼續(xù)檢索父主題。

用法

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

參數(shù)

$template_names

（數(shù)組）（必須）要引入的模板文件名（需要擴展名），會根據(jù)數(shù)組逐個匹配文件是否存在，越前邊的優(yōu)先級越高。

默認值：None

$load

（布爾）（可選）如果設(shè)置成 True 則直接引入模板文件。

默認值：False

$require_once

（布爾）（可選）如果設(shè)置成 True 則如果之前引入過這次不再引入（require_once），否則無論是否引入過都會引入（require）。

（只有 $load 為 True，此參數(shù)才生效）。

默認值：False

返回值

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

例子：

1. if( locate_template( 'content-' . $pageName . '.php' ) !== '' ){ 
2.   //存在，引入模板文件 
3.   get_template_part( 'content', $pageName ); 
4. }else{ 
5.   //不存在，直接顯示內(nèi)容 
6.   the_content(); 
7. } 

其它

此函數(shù)位于：wp-includes/template.php

快速檢索模板

get_query_template() 用于快速檢索出頁面模板，而且需要按照預(yù)定的頁面類型（type）。

它和 locate_template() 的不同在于需要填寫頁面的類型，而且會生成 {$type}_template 模板路徑過濾器。

用法

get_query_template( $type, $templates );

參數(shù)

$type

（字符串）（必須）所要獲取的模板文件的頁面的類型，要填對應(yīng)模板文件沒有擴展名的文件名（比如 single）。

默認值：None

$templates

（數(shù)組）（可選）備選的模板列表。

默認值：空數(shù)組

返回值

返回模板文件的路徑。

例子：

如果存在則引入 404 頁面的模板：

if ( '' != get_404_template() ) include( get_404_template() );

其它

此函數(shù)位于：wp-includes/template.php