如何在WordPress插件中使用get_header('tw')加载插件内头部文件

WordPress的get_header()函数默认仅在当前激活主题的目录中查找对应模板文件，不会自动扫描插件目录，所以直接调用get_header('tw')时，会优先使用主题里的header-tw.php，找不到时则回退到默认header.php，完全忽略插件根目录的同名文件。

方法1：直接加载插件目录的模板文件 #

跳过get_header()的默认查找逻辑，手动指定插件文件路径并加载：

// 获取插件根目录下header-tw.php的绝对路径
$plugin_header_path = plugin_dir_path(__FILE__) . 'header-tw.php';

// 检查文件是否存在，存在则加载，否则回退到主题默认header
if (file_exists($plugin_header_path)) {
    include $plugin_header_path;
} else {
    get_header();
}

注意：如果这段代码写在插件的子目录文件中，plugin_dir_path(__FILE__)会指向当前子目录，此时可以先在插件主文件中定义根目录常量：

define('MY_PLUGIN_ROOT', plugin_dir_path(__FILE__));

之后在子目录文件中用MY_PLUGIN_ROOT . 'header-tw.php'获取正确路径。

方法2：通过钩子修改get_header()的查找逻辑 #

使用WordPress的get_header_template过滤器，让get_header('tw')优先查找插件目录的模板：

add_filter('get_header_template', 'my_plugin_load_custom_header');
function my_plugin_load_custom_header($default_template) {
    // 检查当前是否在调用名为'tw'的header模板
    $header_slug = get_query_var('header');
    if ($header_slug === 'tw') {
        $plugin_header = plugin_dir_path(__FILE__) . 'header-tw.php';
        // 如果插件目录存在该文件，返回它的路径
        if (file_exists($plugin_header)) {
            return $plugin_header;
        }
    }
    // 否则返回默认主题模板路径
    return $default_template;
}

将这段代码添加到插件主文件后，直接调用get_header('tw')就会优先加载插件根目录的header-tw.php，不存在时才会使用主题的对应模板。

内容的提问来源于stack exchange，提问作者Naomi S