在WooCommerce自定义订单或下载模板中，分页链接点击后内容始终显示第一页的问题困扰着许多开发者。本文将详细介绍如何通过调整页码获取方式和paginate_links函数参数，确保自定义查询的分页功能正常运作，从而实现正确的页面内容加载。
问题剖析：WooCommerce自定义模板分页挑战
当开发者在WordPress和WooCommerce环境中构建自定义模板（例如，用于展示用户订单历史或可下载产品）时，经常会遇到分页功能失效的问题。具体表现为：用户点击分页链接（如“第2页”）后，URL虽然正确地更新了（例如从mywebsite.com/account/downloads变为mywebsite.com/account/downloads/2），但页面显示的内容却依然是第一页的数据。
这通常发生在自定义循环（Custom Loop）中，特别是当使用wc_get_orders等WooCommerce特有的查询函数时。默认的WordPress分页机制（依赖get_query_var(‘paged’)）可能无法在所有自定义URL结构或Endpoint下正确识别页码。问题的核心在于：
页码获取不准确：模板未能正确地从URL中解析出当前页码。分页链接格式不匹配：paginate_links函数生成的链接格式与查询页码的机制不一致。
解决方案核心：调整分页参数与URL处理
解决此问题的关键在于两步：首先，采用更可靠的方法从URL中获取当前页码；其次，确保paginate_links函数生成的链接格式与新的页码获取机制相匹配。
步骤一：获取当前页码的正确姿势
在许多情况下，get_query_var(‘paged’)可能无法在自定义的WooCommerce Endpoint或重写规则下正确工作。一个更健壮的方法是直接从$_GET请求中获取自定义的页码参数，并进行适当的过滤。
我们将$current_page（或$paged）变量的定义从：
$current_page = ( get_query_var('paged') ) ? get_query_var('paged') : 1;
修改为：
$paged = max( 1, (int) filter_input( INPUT_GET, 'pagina' ) );
解释：
filter_input( INPUT_GET, ‘pagina’ )：这是一个更安全、更明确地从$_GET数组中获取名为pagina的参数的方法。它有助于防止潜在的XSS攻击，并确保我们获取的是一个经过过滤的输入。(int)：将获取到的值强制转换为整数类型，确保其作为页码的有效性。max( 1, … )：确保页码至少为1，避免出现负数或零页码的情况。注意：这里的’pagina’是自定义的查询参数名，你可以根据需要更改，但必须与后续paginate_links的format参数保持一致。
步骤二：配置paginate_links以匹配新的URL结构
为了让paginate_links函数生成与我们新的页码获取方式兼容的URL，我们需要调整其format参数。
在paginate_links的参数数组中，将format值从：
'format' => '%#%', // 或者其他不带查询参数的格式
修改为：
'format' => '?pagina=%#%',
解释：
?pagina=%#%：这告诉paginate_links函数，在生成分页链接时，应该将页码（由%#%占位符表示）作为pagina查询参数添加到URL中。例如，对于第二页，链接将变为mywebsite.com/account/downloads/?pagina=2。注意：base参数也需要正确设置，通常使用wc_get_endpoint_url()来获取当前Endpoint的URL。例如，’base’ => esc_url( wc_get_endpoint_url( ‘libreria’) ) . ‘%_%’。确保libreria与你的自定义Endpoint名称相符。
完整代码示例
以下是经过修正后的WooCommerce自定义订单（或下载）模板代码，其中包含了上述两项关键改动：
customer->get_downloadable_products();$has_downloads = (bool) $downloads;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 ); // 遍历订单并显示内容 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 '
Ordine Prodotto Data Totale Stato File '; } } // 分页按钮 - 负责订单历史的分页按钮和页码 ?>
Ordine #'. esc_attr($orders_id) .' Prodotto '. wp_kses_post($product_name) .' Data '. wp_kses_post($date_created) .' Prezzo '. wp_kses_post($order_total) .' Stato get_status() . '">'. wp_kses_post($status) .' File Visualizza esc_url( wc_get_endpoint_url( 'libreria') ) . '%_%', // 替换 'libreria' 为你的自定义Endpoint // 步骤二：修改 format 参数以匹配新的页码获取方式 'format' => '?pagina=%#%', 'total' => $customer_orders->max_num_pages, 'current' => $paged, 'show_all' => false, 'end_size' => 3, 'mid_size' => 3, 'prev_next' => true, 'prev_text' => __('Indietro'), 'next_text' => __('Avanti'), 'type' => 'plain', 'add_args' => false, 'add_fragment' => '' ); echo paginate_links($args); ?>La tua cronologia ordini è vuota!
关键点与注意事项
get_query_var与filter_input的选择：get_query_var(‘paged’)主要用于WordPress主查询或已注册的查询变量。在自定义模板和Endpoint中，尤其当URL结构不完全遵循WordPress默认的分页规则时，它可能无法按预期工作。filter_input(INPUT_GET, ‘param_name’)直接从$_GET超全局变量中获取参数，并提供了强大的数据过滤和验证功能，更适合处理自定义的URL查询参数。paginate_links参数详解：base：生成链接的基础URL。wc_get_endpoint_url(‘your-endpoint’)是获取WooCommerce自定义Endpoint URL的推荐方式。%_%是paginate_links内部用来替换页码的占位符。format：定义页码如何插入到URL中。将其设置为?pagina=%#%是解决此问题的核心。total：总页数，通常从自定义查询结果中获取（例如$customer_orders->max_num_pages）。current：当前页码，必须与你从URL中获取的页码变量（$paged）保持一致。自定义Endpoint与URL重写：如果你的分页链接是在WooCommerce的My Account页面下的自定义Endpoint中（如/account/libreria），那么wc_get_endpoint_url(‘libreria’)会生成正确的Endpoint基础URL。确保你的WordPress永久链接设置（Permalinks）是除了“朴素”之外的任何一种，这样URL重写才能正常工作。安全性考虑：始终对从用户输入或URL中获取的数据进行过滤和转义。filter_input已经提供了初步的过滤。在输出到HTML时，使用esc_attr(), wp_kses_post(), esc_url()等WordPress函数进行转义，以防止XSS攻击。调试技巧：如果分页仍不工作，请检查浏览器开发者工具中的网络请求，确保分页链接的URL是正确的。使用var_dump($paged);和var_dump($customer_orders);来检查$paged变量是否正确获取了页码，以及wc_get_orders查询结果是否包含了正确的总页数。
总结
通过将页码的获取方式从get_query_var(‘paged’)更改为filter_input(INPUT_GET, ‘pagina’)，并相应地调整paginate_links函数的format参数为?pagina=%#%，可以有效地解决WooCommerce自定义模板中分页链接点击后内容重复加载的问题。这一方法确保了自定义查询能够正确识别和响应URL中的页码参数，从而实现流畅且功能完善的分页体验。
以上就是解决WooCommerce自定义模板分页内容重复加载问题的详细内容，更多请关注php中文网其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1579619.html
微信扫一扫 
支付宝扫一扫 
