WordPress Pods模板：调用get_header()前覆写页面标题失效

我帮你排查了下问题，核心原因是变量作用域和钩子执行时机的冲突，咱们一步步来解决：

问题根源 #

pre_get_document_title 钩子的执行时机其实是在 get_header() 之前的，但你定义的 $seo_title 虽然在 get_header() 之前，可它是全局变量，而你的 custom_page_title 函数内部无法直接访问这个外部变量——函数有自己的独立作用域，所以函数里返回的其实是个未定义的值，自然不会生效。

另外，你用 pods_v_sanitized(3, 'url') 来获取ID的方式也不够稳妥，不如直接用当前页面的ID更可靠。

修正后的代码 #

把获取Pods字段的逻辑移到钩子函数内部，同时增加页面类型判断和空值处理，这样就能正常覆写标题了：

// 自定义页面标题覆写函数
function custom_page_title($default_title) {
    // 只在parcours类型的Pods单页面生效
    if (is_singular('parcours')) {
        $parcours = pods('parcours', get_the_ID());
        $seo_title = $parcours->field('seo_title');
        
        // 如果seo_title有内容就返回，否则保留默认标题
        return !empty($seo_title) ? $seo_title : $default_title;
    }
    
    // 其他页面直接返回默认标题
    return $default_title;
}
add_filter('pre_get_document_title', 'custom_page_title', 999, 1);

// 后续代码正常执行
get_header();
?>

关键细节说明 #

• 作用域问题解决：把获取Pods数据的逻辑放到钩子函数里，确保函数触发时能直接拿到需要的seo_title值
• 页面类型判断：用is_singular('parcours')限定只在目标页面生效，不会影响网站其他页面的标题
• 可靠的ID获取：用get_the_ID()获取当前页面ID，比从URL参数提取更稳定，避免URL结构变化导致的问题
• 空值容错：增加!empty($seo_title)判断，防止字段为空时页面标题变成空白，保留默认标题作为 fallback

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