WordPress根据分类别名/ID选择内容页模板

实现原理

当我们需要为某个特定的文章分类指定专用的内容页（Single Post）模板时，可以通过添加自定义函数到主题的 functions.php 文件来实现。WordPress 提供了 single_template 过滤器，允许我们根据条件动态选择模板文件。

操作步骤

1. 创建模板目录与文件

在当前主题的根目录下，创建一个名为 single 的文件夹。然后，为你需要自定义模板的分类创建对应的模板文件。

文件命名规则：

• 使用分类别名：single-{分类别名}.php
• 使用分类ID：single-{分类ID}.php

例如，如果你的分类别名是 "themes"，ID 是 2，则可以创建：

• single/single-themes.php
• single/single-2.php

系统会优先匹配别名文件，如果不存在，则尝试匹配ID文件。

2. 添加模板选择函数

将以下代码添加到当前主题的 functions.php 文件中：

// 通过分类别名或ID选择自定义单篇文章模板
function wptoo_single_template($single) {
    global $post;
    // 获取当前文章的所有分类
    foreach((array)get_the_category() as $cat) {
        // 1. 优先检查是否存在以分类别名命名的模板文件
        $template_by_slug = TEMPLATEPATH . '/single/single-' . $cat->slug . '.php';
        if(file_exists($template_by_slug)) {
            return $template_by_slug;
        }
        // 2. 如果不存在，则检查是否存在以分类ID命名的模板文件
        $template_by_id = TEMPLATEPATH . '/single/single-' . $cat->term_id . '.php';
        if(file_exists($template_by_id)) {
            return $template_by_id;
        }
    }
    // 如果都没有找到，返回默认的 $single 模板路径
    return $single;
}
// 将函数挂载到 'single_template' 过滤器
add_filter('single_template', 'wptoo_single_template');

函数说明与修正

原始代码存在一处笔误（ingle-）和逻辑优化空间。上述修正后的代码：

1. 修正笔误：将 '/single/ingle-' 更正为 '/single/single-'。
2. 优化逻辑：将 elseif 改为独立的 if 判断，使别名和ID的检查逻辑更清晰。
3. 添加默认返回值：在循环结束后返回原始的 $single 路径，确保当没有匹配到自定义模板时，WordPress 会回退到使用默认的单篇文章模板（如 single.php）。
4. 移除冗余变量：$wp_query 在此函数中并未使用，已移除。

效果

完成以上步骤后，当访问属于 "themes" 分类（或ID为2的分类）下的任何文章时，WordPress 将自动使用 single/single-themes.php（或 single/single-2.php）作为其内容页模板，从而实现分类级别的模板定制。