WordPress编程设置locale时菜单项不翻译的解决方法

问题核心原因 #

之前的代码存在两个关键问题，导致菜单翻译逻辑无法正常触发：

1. 钩子名拼写错误：代码中挂载的plugin_loaded是错误钩子名，WordPress核心标准钩子为复数形式plugins_loaded，错误的钩子会导致语言设置函数执行时机完全不可控，大概率在多语言插件完成菜单语言规则绑定后才运行，菜单查询的语言条件已经被固定为默认语言。
2. 未同步多语言插件状态：switch_to_locale()只会修改WordPress核心的全局locale值，WP Multilang的菜单项过滤逻辑依赖自身内部存储的语言状态，不会主动读取核心locale返回值，单独调用核心切换函数无法触发插件的翻译规则加载。

手动修改$_REQUEST['lang'] = 'de'能生效，本质是刚好命中了WP Multilang初始化时的超全局参数检测逻辑，但这种篡改请求参数的写法会干扰其他插件的参数判断，不符合WordPress编码规范。

可落地的规范实现方案 #

第一步：修正语言设置的挂载逻辑 #

将语言切换逻辑挂载到正确的plugins_loaded钩子，设置优先级为0（早于所有插件默认的10优先级执行），同时调用WP Multilang公开API同步语言状态，代码如下：

// 钩子名使用正确的复数形式，优先级设为0保证在插件初始化前执行
add_action( 'plugins_loaded', 'set_custom_site_language', 0 );
function set_custom_site_language() {
    // 替换为你自己的URL规则判断逻辑，判断当前页面需要加载德语时执行切换
    $need_load_german = false;
    // 示例判断逻辑：如果访问路径包含/de/前缀则加载德语，可根据自身规则修改
    if (str_starts_with(parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH), '/de/')) {
        $need_load_german = true;
    }

    if ($need_load_german) {
        // 调用WP Multilang公开API设置当前语言，替代手动修改$_REQUEST的不规范写法
        if (function_exists('wpm_set_language')) {
            wpm_set_language('de');
        }
        // 同步切换WordPress核心locale，保证主题、其他插件正常识别语言
        switch_to_locale('de_DE');
    }
}

第二步：补充菜单渲染前的语言校验（可选，用于兼容极端缓存场景） #

如果第一步执行后仍有个别菜单项未翻译，添加Max Mega Menu渲染前的钩子，在菜单输出前二次确认语言上下文：

add_filter('max_mega_menu_start_menu_render', function($menu_settings) {
    // 复用和上面一致的德语判断逻辑
    $need_load_german = str_starts_with(parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH), '/de/');
    if ($need_load_german) {
        if (function_exists('wpm_set_language')) {
            wpm_set_language('de');
        }
        if (get_locale() !== 'de_DE') {
            switch_to_locale('de_DE');
        }
    }
    return $menu_settings;
}, 1);

第三步：清理缓存生效 #

代码部署完成后必须清理三类缓存，否则旧的菜单缓存会导致修改不生效：

• 清空站点使用的页面缓存、对象缓存
• 进入Max Mega Menu设置页，清空插件自带的菜单缓存
• 进入WP Multilang设置页，重新保存一次固定链接与多语言规则，刷新多语言内容映射表

之前尝试无效的原因说明 #

• 更换主题、菜单插件无法解决问题：问题根源是语言切换的时机和多语言插件状态同步问题，和主题、菜单插件本身功能无关
• 单独使用locale过滤器、在其他钩子挂载switch_to_locale()无效：没有同步WP Multilang内部的语言状态，且执行时机晚于多语言插件的菜单规则绑定阶段，无法修改已经生成的菜单查询条件

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