如何为多语言博客首页强制加载指定WordPress区块模板

实现步骤 #

1. 准备关键信息 #

• 提取目标区块模板ID：进入WordPress后台「站点编辑器 → 模板」，打开对应语言的博客首页模板，查看浏览器地址栏的post=参数，比如post=123，这个数值就是模板ID。
• 确认Polylang语言标识：在Polylang设置页面查看各语言的简写标识（例如中文zh、英文en）。

2. 插入自定义代码 #

将以下代码添加到子主题的functions.php文件中，替换占位符为你的实际信息：

add_filter('block_template_include', 'force_lang_blog_template', 99);
function force_lang_blog_template($template) {
    // 判定当前页面是否为静态博客首页
    if (is_home()) {
        // 获取Polylang当前语言标识
        $current_lang = pll_current_language('slug');
        
        // 建立语言与对应区块模板ID的映射
        $lang_template_map = [
            'zh' => 123, // 替换为中文博客首页模板ID
            'en' => 456  // 替换为英文博客首页模板ID
        ];
        
        // 匹配到对应语言模板时，强制替换加载
        if (isset($lang_template_map[$current_lang])) {
            $target_template = get_block_template($lang_template_map[$current_lang], 'wp_template');
            if ($target_template) {
                return $target_template;
            }
        }
    }
    // 无匹配时返回原模板
    return $template;
}

3. 代码说明 #

• 用block_template_include钩子专门拦截区块模板的加载流程，设置优先级99保证在默认逻辑之后执行。
• is_home()精准定位到你设置的静态博客首页。
• pll_current_language('slug')调用Polylang函数获取当前语言的简写标识。
• 通过数组映射实现语言与模板的关联，找到匹配模板后直接返回，覆盖WordPress默认的模板加载规则。

4. 验证效果 #

保存代码后，切换不同语言访问博客首页，检查是否加载了对应的区块模板。若未生效，可尝试清除WordPress缓存，或调整钩子优先级（比如改为100）。

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