
在开发 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 函数的参数,使其生成的链接与页码获取逻辑相匹配。
传统的 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,防止出现负数或零页码的情况。
paginate_links 函数负责生成分页链接。它的 format 参数定义了页码如何被插入到链接中。为了与我们自定义的 pagina GET 参数匹配,需要相应地修改 format。
原代码片段(可能导致问题):
'format' => '%#%',
优化后的代码片段:
'format' => '?pagina=%#%',
通过将 format 设置为 ?pagina=%#%,paginate_links 将生成类似 ?pagina=2、?pagina=3 这样的链接,与我们通过 filter_input( INPUT_GET, 'pagina' ) 获取页码的方式保持一致。
在构建 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 订单下载模板的关键代码片段:
<?php
defined( 'ABSPATH' ) || exit;
?><div class="orders-container"><?php
$has_downloads = (bool) WC()->customer->get_downloadable_products(); // 检查是否有可下载产品
do_action( 'woocommerce_before_account_downloads', $has_downloads );
if ( $has_downloads ) {
?>
<table class="table_orders heading">
<tr>
<td class="product_number">订单</td>
<td class="product_name">产品</td>
<td class="product_data">日期</td>
<td class="product_price">总计</td>
<td class="product_status">状态</td>
<td class="product_action">文件</td>
</tr>
</table>
<?php
$order_statuses = array('wc-completed');
// 核心改动 1: 安全地获取当前页码
$paged = max( 1, (int) filter_input( INPUT_GET, 'pagina' ) );
$args = apply_filters('woocommerce_my_account_my_orders_query', array(
'customer_id' => 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 '
<table class="table_orders">
<tr class="table_row_items">
<td class="product_number">
<span class="mobile title">订单</span>
<span>#'. esc_attr($orders_id) .'</span>
</td>
<td class="product_name">
<span class="mobile title">产品</span>
<a href="'. wp_kses_post($view_order) .'">'. wp_kses_post($product_name) .'</a>
</td>
<td class="product_data">
<span class="mobile title">日期</span>
<span>'. wp_kses_post($date_created) .'</span>
</td>
<td class="product_price">
<span class="mobile title">价格</span>
<span>'. wp_kses_post($order_total) .'</span>
</td>
<td class="product_status">
<span class="mobile title">状态</span>
<span class="label ' . $order->get_status() . '">'. wp_kses_post($status) .'</span>
</td>
<td class="product_action">
<span class="mobile title">文件</span>
<a target=”_blank” href="'. esc_url($view_order) .'">查看<i class="fa-duotone fa-eye"></i></a>
</td>
</tr>
</table>
';
}
}
} else {
?><div class="msg_orders">您的订单历史为空!</div><?php
}
// 分页按钮
?><div class="container-pagination"><?php
$pagination_args = array(
'base' => 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' => __('<i class="fa-regular fa-angle-left"></i><span>上一页</span>'),
'next_text' => __('<span>下一页</span><i class="fa-regular fa-angle-right"></i>'),
'type' => 'plain',
'add_args' => false,
'add_fragment' => ''
);
echo paginate_links($pagination_args);
?></div><?php
} else {
?><div class="msg_orders">没有可下载的产品。</div><?php
}
do_action( 'woocommerce_after_account_downloads', $has_downloads );
?></div>通过上述调整,我们成功地解决了 WooCommerce 自定义模板中分页链接内容重复的问题。核心在于放弃在自定义查询中对 get_query_var('paged') 的依赖,转而使用自定义的 GET 参数 (pagina) 来传递页码,并相应地配置 paginate_links 函数以生成正确的链接格式。这种方法为自定义 WooCommerce 列表的分页提供了更稳定和可控的解决方案,极大地提升了用户体验。
以上就是解决 WooCommerce 自定义模板中分页链接内容重复的问题的详细内容,更多请关注php中文网其它相关文章!
每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号