如何将WordPress含query的分页URL转换为标准格式？

要将http://website.com/all-articles/?query-3-page=3（含可选&cst参数）转换为http://website.com/all-articles?page=3格式，需要从旧URL跳转和生成新URL两方面处理，具体步骤如下：

1. 用.htaccess实现旧URL永久重定向 #

在网站根目录的.htaccess文件中，# BEGIN WordPress注释前添加以下规则，确保旧链接自动跳转到新格式（兼容SEO）：

# 重写query-3-page分页链接，忽略cst参数
RewriteCond %{QUERY_STRING} ^query-3-page=([0-9]+)(&cst=.+)?$
RewriteRule ^all-articles/?$ /all-articles?page=%1 [R=301,L]

• R=301表示永久重定向，利于搜索引擎收录更新
• 规则会匹配带query-3-page和任意cst参数的链接，统一跳转至page=数字格式

2. 修改WordPress分页链接生成逻辑 #

在主题/子主题的functions.php中添加以下代码，让系统直接生成正确格式的分页链接，避免再产出旧URL：

// 修正分页链接参数
add_filter('paginate_links', 'custom_fix_pagination_url');
function custom_fix_pagination_url($link) {
    if (is_page('all-articles')) {
        // 替换query-3-page为page
        $link = str_replace('query-3-page=', 'page=', $link);
        // 移除cst参数
        $link = preg_replace('/&cst=[^&]+/', '', $link);
        // 清理链接末尾多余的&或?符号
        $link = rtrim($link, '&?');
    }
    return $link;
}

// 让WordPress识别新的page分页参数
add_action('pre_get_posts', 'custom_set_paged_parameter');
function custom_set_paged_parameter($query) {
    if (!is_admin() && is_page('all-articles') && $query->is_main_query()) {
        // 将page参数映射为WP_Query需要的paged参数
        $paged = get_query_var('page') ? get_query_var('page') : 1;
        $query->set('paged', $paged);
        // 清空默认page参数，避免与多页面文章功能冲突
        $query->set('page', '');
    }
}

3. 测试验证 #

• 访问旧格式URL（如all-articles/?query-3-page=3&cst=123），应自动跳转至all-articles?page=3
• 查看all-articles页面的分页按钮，链接应直接显示为page=数字格式，无多余参数

注意事项 #

• 修改.htaccess前请备份原文件，避免配置错误导致网站无法访问
• 若使用缓存插件，需清除缓存后再测试
• 建议使用子主题添加自定义代码，避免主题更新时丢失修改

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