WordPress插件开发：URL含指定参数时展示自定义页面

嘿，这个问题我熟！你现在遇到的是典型的「内容追加」而非「内容替换」问题——你的函数只是在原页面的输出流程里插了内容，但WordPress还是会继续加载原本的文章模板，所以两者混在一起了。要实现完全替换成插件生成的页面，你需要拦截WordPress的默认输出流程，具体做法如下：

核心思路 #

利用WordPress的template_redirect钩子，在它确定要加载哪个模板之后、实际输出内容之前，检查URL参数是否存在。如果存在，直接输出你的自定义页面，然后终止后续所有流程，这样原页面的内容就不会被加载了。

具体代码实现 #

add_action('template_redirect', 'custom_param_triggered_page');
function custom_param_triggered_page() {
    // 严格检查URL参数是否存在且值符合预期
    if (isset($_GET['param']) && $_GET['param'] === '1') {
        // 输出自定义页面的完整HTML结构
        ?>
        <!DOCTYPE html>
        <html lang="<?php echo get_locale(); ?>">
        <head>
            <meta charset="<?php bloginfo('charset'); ?>">
            <title>自定义插件页面</title>
            <?php wp_head(); // 保留站点的头部资源（样式、脚本等） ?>
        </head>
        <body>
            <div class="custom-page-container">
                <h1>这是插件生成的专属页面</h1>
                <p>只有当URL中带有?param=1时，才会看到这个内容</p>
                <!-- 这里可以添加更多自定义内容，比如调用WordPress函数获取数据 -->
                <p>当前站点名称：<?php bloginfo('name'); ?></p>
            </div>
            <?php wp_footer(); // 保留站点的底部资源 ?>
        </body>
        </html>
        <?php
        // 终止后续所有流程，阻止原页面内容输出
        exit();
    }
}

关键注意事项 #

• 为什么选template_redirect？ 这个钩子的触发时机刚好在模板加载前，是拦截默认输出最安全的时机。如果用the_content这类钩子，只是在原文章内容里插入内容，无法阻止原模板的其他部分（比如页眉、侧边栏、页脚）显示。
• 安全验证不能少：如果你的参数需要接收用户输入，一定要做 sanitize 处理，比如$param = sanitize_text_field($_GET['param']);，避免XSS攻击或者恶意参数注入。
• 保留WordPress资源：调用wp_head()和wp_footer()可以让你的自定义页面继承站点的主题样式和脚本，不会显得格格不入。如果不需要站点样式，也可以直接写纯HTML，跳过这两个函数。

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