函数描述
在 WordPress 环境中加载模板文件,此函数的目的是确保在 WordPress 函数中正确地载模板文件,也可以使用查询参数访问这个函数。
使用方法
<?php load_template( $_template_file, $require_once ) ?>
参数
- $_template_file
- (
string) (
required) 模板文件的路径- Default:
None
- Default:
- $require_once
- (
bool) (
optional) 使用 require_once 还是 require 加载- Default: 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' );
}