引言
在开发 woocommerce 自定义模板，特别是针对用户账户页面（如“我的下载”或“我的订单”），并尝试实现订单列表分页功能时，开发者可能会遇到一个常见问题：尽管分页链接的 url 正确地指向了不同的页码（例如 mywebsite.com/account/downloads/2），但页面内容却始终停留在第一页。这通常是由于 wordpress 处理自定义查询和分页变量的方式与预期不符所导致的。
问题根源分析
在 WordPress 和 WooCommerce 环境中，get_query_var('paged') 通常用于获取当前分页页码。然而，在自定义模板或特定自定义端点（endpoint）中，尤其当 URL 结构不完全遵循 WordPress 默认的 paged 重写规则时，get_query_var('paged') 可能无法正确捕获 URL 中的页码信息。例如，如果分页链接是 ?pagina=2 这样的 GET 参数形式，而并非 /page/2/ 这样的美化链接形式，get_query_var('paged') 就不会自动识别。
当 wc_get_orders 函数用于构建自定义订单列表时，它依赖于正确的 paged 参数来执行数据库查询。如果这个参数未能正确传递，wc_get_orders 将默认返回第一页的数据，导致分页功能失效。
解决方案：核心步骤
解决此问题的关键在于两点：一是确保正确地从 URL 中获取当前页码；二是调整 paginate_links 函数的参数，使其生成的链接与页码获取逻辑相匹配。
1. 优化当前页码获取方式
传统的 get_query_var('paged') 方法在此场景下可能失效。我们需要转而使用 PHP 的 filter_input 函数来直接从 GET 请求中获取自定义的页码参数。
原代码片段（可能导致问题）：
$current_page = ( get_query_var('paged') ) ? get_query_var('paged') : 1;优化后的代码片段：
$paged = max( 1, (int) filter_input( INPUT_GET, 'pagina' ) );
这里，我们定义了一个名为 pagina 的 GET 参数来承载页码信息。filter_input( INPUT_GET, 'pagina' ) 安全地获取 $_GET['pagina'] 的值。max( 1, ... ) 确保页码至少为 1，防止出现负数或零页码的情况。
2. 调整 paginate_links 函数的 format 参数
paginate_links 函数负责生成分页链接。它的 format 参数定义了页码如何被插入到链接中。为了与我们自定义的 pagina GET 参数匹配，需要相应地修改 format。
酷纬企业网站管理系统Kuwebs是酷纬信息开发的为企业网站提供解决方案而开发的营销型网站系统。在线留言模块、常见问题模块、友情链接模块。前台采用DIV+CSS，遵循SEO标准。 1.支持中文、英文两种版本，后台可以在不同的环境下编辑中英文。 3.程序和界面分离，提供通用的PHP标准语法字段供前台调用，可以为不同的页面设置不同的风格。 5.支持google地图生成、自定义标题、自定义关键词、自定义描
原代码片段（可能导致问题）：
'format' => '%#%',
优化后的代码片段：
'format' => '?pagina=%#%',
通过将 format 设置为 ?pagina=%#%，paginate_links 将生成类似 ?pagina=2、?pagina=3 这样的链接，与我们通过 filter_input( INPUT_GET, 'pagina' ) 获取页码的方式保持一致。
3. 将新页码变量传递给 wc_get_orders
在构建 wc_get_orders 的查询参数时，确保使用新的 $paged 变量。
$args = array(
'customer_id' => get_current_user_id(),
'post_status' => $order_statuses,
'paged' => $paged, // 使用新的 $paged 变量
'posts_per_page' => 3,
'paginate' => true,
);
$customer_orders = wc_get_orders( $args );示例代码
以下是一个整合了上述解决方案的自定义 WooCommerce 订单下载模板的关键代码片段：
customer->get_downloadable_products(); // 检查是否有可下载产品 do_action( 'woocommerce_before_account_downloads', $has_downloads ); if ( $has_downloads ) { ?>get_current_user_id(), 'post_status' => $order_statuses, 'paged' => $paged, // 将获取到的页码传递给查询 'posts_per_page' => 3, // 每页显示订单数 'paginate' => true, // 启用分页 )); $customer_orders = wc_get_orders( $args ); // 遍历订单并显示内容 if ($customer_orders && !empty($customer_orders->orders)) { foreach($customer_orders->orders as $order) { $orders_id = $order->get_id(); $status = wc_get_order_status_name( $order->get_status() ); $date_created = $order->get_date_created()->date('d/m/Y'); $order_total = $order->get_formatted_order_total(); $view_order = $order->get_view_order_url(); foreach($order->get_items() as $item_id => $item) { $product_name = $item->get_name(); // ... 其他产品信息和显示逻辑 ... echo '
订单 产品 日期 总计 状态 文件 '; } } } else { ?>
订单 #'. esc_attr($orders_id) .' 产品 '. wp_kses_post($product_name) .' 日期 '. wp_kses_post($date_created) .' 价格 '. wp_kses_post($order_total) .' 状态 '. wp_kses_post($status) .' 文件 查看 您的订单历史为空！esc_url( wc_get_endpoint_url( 'libreria') ) . '%_%', // 请将 'libreria' 替换为你的实际端点名称 // 核心改动 2: 调整 format 参数以匹配自定义 GET 参数 'format' => '?pagina=%#%', 'total' => $customer_orders->max_num_pages, 'current' => $paged, // 使用新的 $paged 变量 'show_all' => false, 'end_size' => 3, 'mid_size' => 3, 'prev_next' => true, 'prev_text' => __('上一页'), 'next_text' => __('下一页'), 'type' => 'plain', 'add_args' => false, 'add_fragment' => '' ); echo paginate_links($pagination_args); ?>没有可下载的产品。
注意事项
- 参数一致性： 确保 filter_input( INPUT_GET, 'pagina' ) 中的 'pagina' 与 paginate_links 的 'format' => '?pagina=%#%' 中的 'pagina' 严格一致。这是实现分页功能的核心。
- 端点名称： paginate_links 的 base 参数中的 wc_get_endpoint_url( 'libreria' ) 应替换为你的实际 WooCommerce 账户端点 slug（例如，如果你创建了一个名为 downloads 的端点，则应为 'downloads'）。
- wc_get_orders 中的 paginate 参数： 确保在 wc_get_orders 的 $args 中设置 'paginate' => true，这告诉 WooCommerce 查询要计算总页数 (max_num_pages)。
- 安全过滤： 使用 filter_input 是获取 GET 参数的推荐方法，因为它提供了更好的安全性。
- max_num_pages： wc_get_orders 在设置 paginate => true 后，其返回的对象 $customer_orders 会包含 max_num_pages 属性，用于 paginate_links 的 total 参数。
总结
通过上述调整，我们成功地解决了 WooCommerce 自定义模板中分页链接内容重复的问题。核心在于放弃在自定义查询中对 get_query_var('paged') 的依赖，转而使用自定义的 GET 参数 (pagina) 来传递页码，并相应地配置 paginate_links 函数以生成正确的链接格式。这种方法为自定义 WooCommerce 列表的分页提供了更稳定和可控的解决方案，极大地提升了用户体验。
