本教程详细阐述了在 WooCommerce 自定义模板中，当使用 wc_get_orders 进行订单列表分页时，点击分页链接却始终显示第一页内容的问题。文章提供了明确的解决方案，通过调整获取当前页码的逻辑以及 paginate_links 函数的参数，确保分页功能正常工作，从而优化用户体验。
引言
在开发 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。
原代码片段（可能导致问题）：
'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 ' 订单 #'. esc_attr($orders_id) .' 产品 '. wp_kses_post($product_name) .' 日期 '. wp_kses_post($date_created) .' 价格 '. wp_kses_post($order_total) .' 状态 get_status() . '">'. wp_kses_post($status) .' 文件 查看 '; } } } else { ?>您的订单历史为空！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 列表的分页提供了更稳定和可控的解决方案，极大地提升了用户体验。
以上就是解决 WooCommerce 自定义模板中分页链接内容重复的问题的详细内容，更多请关注php中文网其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1579511.html
微信扫一扫 
支付宝扫一扫 
