解决WooCommerce自定义模板分页加载重复内容的问题

花韻仙語
发布: 2025-09-28 13:33:01
原创
288人浏览过

解决woocommerce自定义模板分页加载重复内容的问题

本教程详细阐述了在WooCommerce自定义模板中,分页链接加载相同页面内容的问题及其解决方案。核心在于调整当前页码的获取方式,从get_query_var('paged')改为使用filter_input读取自定义GET参数,并相应修改paginate_links函数的format参数,确保分页链接能正确指向不同页面的内容。

问题描述

在开发自定义WooCommerce模板(例如,用于显示用户下载或订单历史的downloads.php或类似文件)时,开发者可能会遇到一个常见的分页问题:当点击分页链接(如“第2页”)时,URL会正确地更新(例如,从mywebsite.com/account/downloads变为mywebsite.com/account/downloads/2),但页面显示的内容却始终是第一页的数据。这表明尽管URL结构发生了变化,但后端查询并未正确识别并处理页码参数。

最初尝试使用get_query_var('paged')来获取当前页码,但这种方法在自定义wc_get_orders查询中可能无法按预期工作,因为它通常与WordPress主查询的重写规则更紧密相关。

理解WordPress与WooCommerce中的分页机制

WordPress默认的分页机制依赖于其重写规则来解析URL中的页码(例如/page/2/)。然而,当我们在自定义模板中使用wc_get_orders等函数构建独立于主查询的自定义查询时,WordPress的默认分页变量paged可能无法自动被正确识别和传递。为了确保自定义查询能够响应分页链接,我们需要明确地定义如何获取当前页码,以及如何构造分页链接的URL。

解决方案

解决此问题的关键在于两步:修改当前页码的获取方式调整paginate_links函数的format参数,使其协同工作。

步骤一:调整当前页码变量的获取方式

不再使用get_query_var('paged'),而是通过filter_input函数安全地从URL的GET参数中读取自定义的页码变量。

原代码示例(可能存在问题):

$current_page = ( get_query_var('paged') ) ? get_query_var('paged') : 1;
登录后复制

修改为:

$paged = max( 1, (int) filter_input( INPUT_GET, 'pagina' ) );
登录后复制

解释:

AiPPT模板广场
AiPPT模板广场

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

AiPPT模板广场 147
查看详情 AiPPT模板广场
  • filter_input( INPUT_GET, 'pagina' ):这是一个更安全、更推荐的方式来获取GET请求参数。INPUT_GET指定从GET请求中获取,'pagina'是我们自定义的URL参数名称。
  • (int):将获取到的参数强制转换为整数类型,确保其为有效的页码。
  • max( 1, ... ):确保页码至少为1,避免出现负数或零页码的情况。
  • 这里我们将自定义的GET参数命名为pagina。您可以根据自己的偏好选择其他名称,但请确保在后续步骤中保持一致。

步骤二:配置paginate_links函数的format参数

为了让paginate_links函数生成包含我们自定义GET参数的正确分页URL,需要修改其format参数。

原代码示例(可能存在问题):

'format' => '%#%',
登录后复制

修改为:

'format' => '?pagina=%#%',
登录后复制

解释:

  • %#%是paginate_links函数中的一个占位符,它会被实际的页码替换。
  • 通过将format设置为'?pagina=%#%',我们指示paginate_links生成形如?pagina=2、?pagina=3这样的URL参数,而不是依赖WordPress默认的路径式分页(如/page/2/)。这样,当用户点击分页链接时,URL中会包含?pagina=N,我们的自定义查询就能通过filter_input( INPUT_GET, 'pagina' )正确读取到页码。

此外,在paginate_links的base参数中,也需要确保指向正确的端点URL。例如,如果您的自定义页面是WooCommerce我的账户下的一个端点,可以使用wc_get_endpoint_url('your-endpoint-slug')。在提供的解决方案中,'libreria'被用作端点。

'base' => esc_url( wc_get_endpoint_url( 'libreria') ) . '%_%',
登录后复制

完整示例代码

以下是整合了上述解决方案的自定义WooCommerce模板代码示例:

<?php

?><div class="orders-container"><?php

defined( 'ABSPATH' ) || exit;

$downloads     = WC()->customer->get_downloadable_products();
$has_downloads = (bool) $downloads;

do_action( 'woocommerce_before_account_downloads', $has_downloads );

if ( $has_downloads ) {

 ?><table class="table_orders heading"><tr>
  <td class="product_number">Ordine</td>
  <td class="product_name">Prodotto</td>
  <td class="product_data">Data</td>
  <td class="product_price">Totale</td>
  <td class="product_status">Stato</td>
   <td class="product_action">File</td>
 </tr></table><?php


    $order_statuses = array('wc-completed');
    // 步骤一:调整当前页码的获取方式
    $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, // 使用新的 $paged 变量
    'posts_per_page'  => 3, // 每页显示订单数,可根据需要调整
    'paginate'        => true,
    ));
    $customer_orders = wc_get_orders( $args );

    // Get Access $order variable Foreach - Definisci le variabili sotto per poi utilizzarle in echo
    foreach($customer_orders->orders as $order) {
     // Get $product object from $order / $order_id
     $orders_id = $order->get_id();
     $status =  wc_get_order_status_name( $order->get_status() );
     $date_created = $order->get_date_created()->date('d/m/Y');
     $payment_method = $order->get_payment_method_title();
     $order_total = $order->get_formatted_order_total();

        // Get Access Items & Product Variable Foreach
        foreach($order->get_items() as $item_id => $item) {
         $product_name = $item->get_name();
         $view_order = $order->get_view_order_url();

         // Get product image - https://www.businessbloomer.com/woocommerce-easily-get-product-info-title-sku-desc-product-object/
         $product = $item->get_product();
            if( $product instanceof WC_Product ){
             $order_img = $product->get_image();
            }

         //Get product download button 
         $downloads = $order->get_downloadable_items();
            if(is_array($downloads)) {
                foreach($downloads as $product){
                 $download_button = '<a href="'. $product['download_url'] .'" target="_blank">Download</a>';
                } 
            } 

            echo '
                <table class="table_orders">
                <tr class="table_row_items">
                    <td class="product_number">
                     <span class="mobile title">Ordine</span>
                     <span>#'. esc_attr($orders_id) .'</span>
                    </td>

                    <td class="product_name">
                     <span class="mobile title">Prodotto</span>
                     <a href="'. wp_kses_post($view_order) .'">'. wp_kses_post($product_name) .'</a>
                    </td>

                    <td class="product_data">
                     <span class="mobile title">Data</span>
                     <span>'. wp_kses_post($date_created) .'</span>
                    </td>

                    <td class="product_price">
                     <span class="mobile title">Prezzo</span>
                     <span>'. wp_kses_post($order_total) .'</span>
                    </td>

                    <td class="product_status">
                     <span class="mobile title">Stato</span>
                     <span class="label ' . $order->get_status() . '">'. wp_kses_post($status) .'</span>
                    </td>

                    <td class="product_action">
                     <span class="mobile title">File</span>
                     <a target=”_blank” href="'. esc_url($view_order) .'">Visualizza<i class="fa-duotone fa-eye"></i></a>
                    </td>
                </tr>    
                </table> 
            ';

            // Tasto download funzionante - if($downloads) { echo '<div class="container_orders_download"> '. $download_button .' </div>'; }
        }
    }


    // Pagination button - Responsabile dei bottoni e numerazione delle pagine della cronologia ordini
    ?><div class="container-pagination"><?php 
        $args = array(
         'base'          => esc_url( wc_get_endpoint_url( 'libreria') ) . '%_%', // 确保这里的端点名称与您的设置一致
         'format'        => '?pagina=%#%', // 步骤二:修改 format 参数
         '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>Indietro</span>'), 
         'next_text' => __('<span>Avanti</span><i class="fa-regular fa-angle-right"></i>'),
         'type'          => 'plain',
         'add_args'      => false,
         'add_fragment'  => ''
        ); 
    echo paginate_links($args);   
}       
        else {
         ?><div class="msg_orders">La tua cronologia ordini è vuota!</div><?php
        } 
    ?></div><?php
    do_action( 'woocommerce_after_account_downloads', $has_downloads );

?>
</div>
登录后复制

注意事项

  1. 端点名称一致性: 在wc_get_endpoint_url()函数中使用的端点名称(例如'libreria')必须与您在WooCommerce设置中或通过代码注册的自定义账户端点名称完全一致。
  2. pagina参数: filter_input( INPUT_GET, 'pagina' )中的'pagina'与format参数中的'?pagina=%#%'必须保持一致。如果您选择其他名称,请确保两处都进行修改。
  3. 安全性: 使用filter_input是获取GET参数的推荐方式,因为它提供了数据过滤和验证的功能,有助于防止XSS等安全漏洞。
  4. 调试: 如果遇到问题,可以启用WordPress的调试模式(在wp-config.php中设置define( 'WP_DEBUG', true );)来查看是否有PHP错误或警告,这有助于定位问题。
  5. 缓存: 在进行此类更改后,请清除任何WordPress或服务器级别的缓存,以确保新的代码逻辑能够正确执行。

总结

在WooCommerce自定义模板中实现正确的分页,关键在于理解自定义查询与WordPress默认分页机制之间的差异。通过将当前页码的获取方式从get_query_var('paged')切换到使用filter_input读取自定义GET参数,并相应地调整paginate_links函数的format参数,我们可以确保分页链接能够正确地更新URL并加载对应页面的内容,从而提供无缝的用户体验。这种方法提供了一种灵活且健壮的解决方案,适用于需要精细控制分页逻辑的自定义场景。

以上就是解决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号