函数描述
在WordPress环境中加载模板文件,此函数的目的是确保在WordPress函数中正确地载模板文件,也可以使用查询参数访问这个函数。
使用方法
load_template( $_template_file, $require_once );
参数
参数 | 数据类型 | 是否必需 | 描述 | 默认值 |
---|---|---|---|---|
$_template_file | 字符串 | 是 | 默认文件路由 | 无 |
$require_once | 布尔值 | 否 | 使用require_once还是require加载文件 | true |
返回值
(void) 该函数没有返回值
使用示例
在我们常用的WordPress电子商务插件中,我们使用主题中的WooCommerce文件中的模板覆盖插件默认的模板,这个功能的实现就是使用的这个函数,具体使用方法如下:
在插件中加载模板,但是允许主题活子主题覆盖
if ( $overridden_template = locate_template( 'some-template.php' ) ) {
// locate_template() 返回文件路径
// 如果主题或子主题覆盖了模板,加载主题中的模板
load_template( $overridden_template );
} else {
// 如果主题或子主题没有覆盖,使用插件中'templates'目录中的默认模板
load_template( dirname( __FILE__ ) . '/templates/some-template.php' );
}