解决WordPress自定义查询变量与模板加载问题

add_filter('query_vars', function ($query_vars) {
    $query_vars[] = 'wps_service_id'; // 添加你的自定义查询变量名
    return $query_vars;
});

add_action('init', function () {
    add_rewrite_rule(
        'services/([a-z0-9-]+)/?$', // 匹配的URL模式
        'index.php?wps_service_id=$matches[1]', // 内部重写目标
        'top' // 规则优先级，'top'表示最高优先级
    );
});

// 插件激活时
register_activation_hook(__FILE__, 'my_plugin_activate');
function my_plugin_activate() {
    // 确保在init钩子之后执行，以包含你的规则
    my_plugin_add_rewrite_rules(); // 你的add_rewrite_rule函数
    flush_rewrite_rules();
}

// 插件停用时
register_deactivation_hook(__FILE__, 'my_plugin_deactivate');
function my_plugin_deactivate() {
    flush_rewrite_rules();
}

// 确保在init钩子中调用 add_rewrite_rule
add_action('init', 'my_plugin_add_rewrite_rules');
function my_plugin_add_rewrite_rules() {
    add_rewrite_rule(
        'services/([a-z0-9-]+)/?$',
        'index.php?wps_service_id=$matches[1]',
        'top'
    );
}

// 错误的模板加载方式
add_action('parse_request', function (&$wp) {
    if (array_key_exists('wps_service_id', $wp->query_vars)) {
        require plugin_dir_path(__DIR__) . "views/service.php";
        exit(); // 问题所在！
    }
    return;
});

// 正确的模板加载方式
add_filter('template_include', function ($template) {
    // 获取自定义查询变量
    $service_id = get_query_var('wps_service_id');

    // 如果自定义查询变量存在且非空
    if (!empty($service_id)) {
        // 定义你的自定义模板文件路径
        $plugin_template = plugin_dir_path(__DIR__) . "views/service.php";

        // 检查模板文件是否存在
        if (file_exists($plugin_template)) {
            return $plugin_template; // 返回自定义模板路径
        }
    }
    return $template; // 如果不符合条件，返回WordPress默认的模板
});

<?php
/**
 * Plugin Name: My Custom Service Plugin
 * Description: Demonstrates proper custom query vars and template loading.
 * Version: 1.0
 * Author: Your Name
 */

// 1. 注册自定义查询变量
add_filter('query_vars', function ($query_vars) {
    $query_vars[] = 'wps_service_id';
    return $query_vars;
});

// 2. 定义自定义重写规则
add_action('init', 'my_plugin_add_rewrite_rules');
function my_plugin_add_rewrite_rules() {
    add_rewrite_rule(
        'services/([a-z0-9-]+)/?$',
        'index.php?wps_service_id=$matches[1]',
        'top'
    );
}

// 插件激活时刷新重写规则
register_activation_hook(__FILE__, 'my_plugin_activate');
function my_plugin_activate() {
    my_plugin_add_rewrite_rules(); // 确保规则已添加
    flush_rewrite_rules();
}

// 插件停用时刷新重写规则
register_deactivation_hook(__FILE__, 'my_plugin_deactivate');
function my_plugin_deactivate() {
    flush_rewrite_rules();
}

// 3. 使用 template_include 过滤器加载自定义模板
add_filter('template_include', function ($template) {
    $service_id = get_query_var('wps_service_id');

    if (!empty($service_id)) {
        // 确保路径正确，这里假设模板在插件根目录下的 'views' 文件夹中
        $plugin_template = plugin_dir_path(__FILE__) . "views/service.php"; 

        if (file_exists($plugin_template)) {
            return $plugin_template;
        }
    }
    return $template;
});

// 示例：views/service.php 模板文件内容
/*
<?php
// views/service.php
get_header(); 

$service_id = get_query_var('wps_service_id');
?>

<div id="primary" class="content-area">
    <main id="main" class="site-main">
        <h1>Service Details for: <?php echo esc_html($service_id); ?></h1>
        <p>This is a custom service page loaded by the plugin.</p>
        <?php
        // 在这里可以根据 $service_id 从数据库获取更多数据并显示
        ?>
    </main>
</div>

<?php get_footer(); ?>
*/