WordPress自定义页面动态标题设置：wp_title过滤器无效怎么解决？

阿华AIGC实验室

2026-5-29

解决WordPress自定义页面个性化标题的问题

当然可以直接在自定义页面代码里实现！你之前的代码没生效，大概率是因为现在大部分现代WordPress主题都启用了title-tag支持，这时候旧的wp_title钩子已经不再主导页面标题的生成了，取而代之的是document_title_parts钩子。下面给你两种适配不同场景的解决方案：

方案1：适配启用`title-tag`的现代主题

这是目前推荐的做法，在你的自定义页面模板（比如page-custom.php）的最顶部、get_header();之前添加以下代码：

// 添加标题过滤器，优先级设高确保覆盖其他设置
add_filter( 'document_title_parts', 'my_custom_page_title', 100 );
function my_custom_page_title( $title_parts ) {
    // 这里可以根据需求动态生成标题，比如：
    // 针对不同用户角色设置标题
    if ( current_user_can( 'administrator' ) ) {
        $title_parts['title'] = '管理员专属页面';
    } else {
        $title_parts['title'] = '普通用户页面';
    }
    // 或者根据页面内容、URL参数等自定义
    return $title_parts;
}

// 加载头部
get_header();

// 移除过滤器，避免影响后续页面的标题输出
remove_filter( 'document_title_parts', 'my_custom_page_title', 100 );

方案2：适配仍使用`wp_title()`的旧主题

如果你的主题还在依赖传统的wp_title()函数输出标题，可以调整你原来的代码，优化优先级并增加页面判断，确保只在当前自定义页面生效：

// 提高优先级，确保你的设置能覆盖其他插件/主题的过滤器
add_filter( 'wp_title', 'my_tpl_wp_title', 200 );
function my_tpl_wp_title( $title ) {
    // 只在当前自定义页面模板生效
    if ( is_page_template( 'page-custom.php' ) ) {
        // 这里替换成你的个性化标题逻辑
        $title = 'My new cool title';
    }
    return $title;
}

get_header();

// 可选：移除过滤器，防止影响其他页面
remove_filter( 'wp_title', 'my_tpl_wp_title', 200 );