如何实现 WordPress 页面模板的条件加载（含代码示例）

一、什么是页面模板条件加载？

在 WordPress 中，每一个页面（Page）都可以绑定一个模板文件，如 page.php、page-about.php、自定义模板等。但有时候我们希望根据不同条件加载不同的模板，比如：

根据页面 ID、别名（slug）加载不同内容；
对某些页面加载定制的头部、底部；
为特定类型的内容使用不同的布局结构。

这就需要“条件加载模板”的技术手段。

二、实现方式一：使用 `is_page()` 判断加载模板部分

is_page() 是 WordPress 提供的条件标签，用于判断当前是否是某个页面。我们可以在 page.php 或其它通用模板中使用它来加载不同的模板片段（Partial）。

示例代码：

<?php
if ( is_page('about') ) {
    get_template_part('partials/page', 'about');
} elseif ( is_page(42) ) {
    get_template_part('partials/page', 'special');
} else {
    get_template_part('partials/page', 'default');
}

三、实现方式二：自定义页面模板文件

WordPress 支持为特定页面创建特定模板文件。你只需将模板文件命名为：

page-{slug}.php

或：

page-{id}.php

WordPress 会自动加载对应的模板。

示例：

如果你有一个别名为 about 的页面，创建文件 page-about.php 即可让该页面使用该模板，无需额外代码。

四、实现方式三：使用 `template_include` 过滤器全局控制模板路径

如果你想通过代码全局控制模板加载，可以使用 template_include 过滤器。

示例代码：

add_filter('template_include', 'custom_page_template_loader');

function custom_page_template_loader($template) {
    if (is_page('contact')) {
        $new_template = locate_template('custom-templates/contact-template.php');
        if ($new_template) {
            return $new_template;
        }
    }
    return $template;
}

五、扩展技巧：结合 ACF 或自定义字段控制模板加载

你还可以结合 ACF（Advanced Custom Fields）等插件，在后台创建一个“选择模板”的字段，根据用户的选择来加载不同模板。

示例：

add_filter('template_include', 'acf_based_template_loader');

function acf_based_template_loader($template) {
    if (is_page()) {
        $custom_template = get_field('custom_template');
        if ($custom_template && file_exists(get_template_directory() . "/templates/{$custom_template}.php")) {
            return get_template_directory() . "/templates/{$custom_template}.php";
        }
    }
    return $template;
}