使用函数与页面模板创建WordPress虚拟联系页的问题

看起来你已经走对了路——创建虚拟页面的核心逻辑已经通了，只是差最后一步把模板内容加载进来而已。我给你两种方案，先解决你当前代码的问题，再给你一个更简洁的优化方案：

一、修改现有代码实现需求 #

你当前的代码只是把固定文本赋值给了$post->post_content，要加载templates/contact.php的内容，我们可以利用**输出缓冲（output buffering）**来捕获模板文件的输出，再把它赋值给$post->post_content。

修改后的完整代码：

add_filter( 'the_posts', 'generate_contact_page', -10 );
function generate_contact_page( $posts ) {
    global $wp, $wp_query;
    $url_slug = 'contact'; // 联系页的URL别名
    $template_path = get_template_directory() . '/templates/contact.php'; // 模板文件的绝对路径

    // 检查是否是目标URL，且模板文件存在
    if ( ! defined( 'CONTACT_PAGE' ) && ( strtolower( $wp->request ) == $url_slug ) && file_exists($template_path) ) {
        define( 'CONTACT_PAGE', true );
        
        // 开启输出缓冲，捕获模板内容
        ob_start();
        include $template_path;
        $template_content = ob_get_clean();

        // 创建虚拟页面对象
        $post = new stdClass;
        $post->post_author = 1;
        $post->post_name = $url_slug;
        $post->guid = home_url() . '/' . $url_slug;
        $post->post_title = 'Contact page';
        $post->post_content = $template_content; // 替换为模板的实际内容
        $post->ID = -999;
        $post->post_type = 'page';
        $post->post_status = 'static';
        $post->comment_status = 'closed';
        $post->ping_status = 'open';
        $post->comment_count = 0;
        $post->post_date = current_time( 'mysql' );
        $post->post_date_gmt = current_time( 'mysql', 1 );
        
        $posts = NULL;
        $posts[] = $post;
        
        // 更新WP查询状态，让系统认为这是一个正常页面
        $wp_query->is_page = true;
        $wp_query->is_singular = true;
        $wp_query->is_home = false;
        $wp_query->is_archive = false;
        $wp_query->is_category = false;
        unset( $wp_query->query[ 'error' ] );
        $wp_query->query_vars[ 'error' ] = '';
        $wp_query->is_404 = false;
    }
    return $posts;
}

这里的关键改动：

• 用get_template_directory()获取主题根目录的绝对路径，确保能精准找到你的模板文件
• 用输出缓冲捕获模板的HTML输出，替换原来的固定文本内容

二、更优的解决方案：使用template_redirect钩子 #

其实WordPress有更直接的方式处理这种“虚拟页面”需求——跳过创建虚拟Post的步骤，直接用template_redirect钩子在请求阶段加载指定模板，逻辑更简洁，性能也更好。

代码示例：

add_action( 'template_redirect', 'load_contact_template' );
function load_contact_template() {
    global $wp;
    $url_slug = 'contact';
    
    if ( strtolower( $wp->request ) === $url_slug ) {
        $template_path = get_template_directory() . '/templates/contact.php';
        
        if ( file_exists( $template_path ) ) {
            // 可选：设置页面标题，让浏览器标签和WP的标题函数正常显示
            add_filter( 'wp_title', function() {
                return 'Contact page';
            });
            
            // 直接加载模板并终止后续WP流程
            include $template_path;
            exit;
        }
    }
}

这个方案的优势：

• 代码更简洁，不需要手动创建和维护虚拟Post对象
• 直接跳过WordPress的文章查询流程，减少不必要的性能开销
• 逻辑更直观，完全聚焦“访问指定URL时加载对应模板”的核心需求

如果你希望虚拟页能适配WordPress的模板层级（比如让get_header()、get_footer()等函数正常调用主题的头尾模板），这个方案同样适用——只要你的contact.php里包含这些函数调用即可。

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