解决 WooCommerce 自定义模板中分页链接内容重复的问题

心靈之曲
发布: 2025-09-28 11:47:20
原创
718人浏览过

解决 WooCommerce 自定义模板中分页链接内容重复的问题

本教程详细阐述了在 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。

AiPPT模板广场
AiPPT模板广场

AiPPT模板广场-PPT模板-word文档模板-excel表格模板

AiPPT模板广场 147
查看详情 AiPPT模板广场

原代码片段(可能导致问题):

'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 订单下载模板的关键代码片段:

<?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>
登录后复制

注意事项

  • 参数一致性: 确保 filter_input( INPUT_GET, 'pagina' ) 中的 'pagina' 与 paginate_links 的 'format' =youjiankuohaophpcn '?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中文网其它相关文章!

最佳 Windows 性能的顶级免费优化软件
最佳 Windows 性能的顶级免费优化软件

每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。

下载
来源:php中文网
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn
最新问题
开源免费商场系统广告
热门教程
更多>
最新下载
更多>
网站特效
网站源码
网站素材
前端模板
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新 English
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送
PHP中文网APP
随时随地碎片化学习

Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号