问题描述
在开发自定义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' ) );
解释：
- 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模板代码示例：
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, // 使用新的 $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 = 'Download'; } } echo '
Ordine Prodotto Data Totale Stato File '; // Tasto download funzionante - if($downloads) { echo '
Ordine #'. esc_attr($orders_id) .' Prodotto '. wp_kses_post($product_name) .' Data '. wp_kses_post($date_created) .' Prezzo '. wp_kses_post($order_total) .' Stato '. wp_kses_post($status) .' File Visualizza '. $download_button .''; } } } // Pagination button - Responsabile dei bottoni e numerazione delle pagine della cronologia ordini ?>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' => __('Indietro'), 'next_text' => __('Avanti'), 'type' => 'plain', 'add_args' => false, 'add_fragment' => '' ); echo paginate_links($args); } else { ?>La tua cronologia ordini è vuota!
注意事项
- 端点名称一致性： 在wc_get_endpoint_url()函数中使用的端点名称（例如'libreria'）必须与您在WooCommerce设置中或通过代码注册的自定义账户端点名称完全一致。
- pagina参数： filter_input( INPUT_GET, 'pagina' )中的'pagina'与format参数中的'?pagina=%#%'必须保持一致。如果您选择其他名称，请确保两处都进行修改。
- 安全性： 使用filter_input是获取GET参数的推荐方式，因为它提供了数据过滤和验证的功能，有助于防止XSS等安全漏洞。
- 调试： 如果遇到问题，可以启用WordPress的调试模式（在wp-config.php中设置define( 'WP_DEBUG', true );）来查看是否有PHP错误或警告，这有助于定位问题。
- 缓存： 在进行此类更改后，请清除任何WordPress或服务器级别的缓存，以确保新的代码逻辑能够正确执行。
总结
在WooCommerce自定义模板中实现正确的分页，关键在于理解自定义查询与WordPress默认分页机制之间的差异。通过将当前页码的获取方式从get_query_var('paged')切换到使用filter_input读取自定义GET参数，并相应地调整paginate_links函数的format参数，我们可以确保分页链接能够正确地更新URL并加载对应页面的内容，从而提供无缝的用户体验。这种方法提供了一种灵活且健壮的解决方案，适用于需要精细控制分页逻辑的自定义场景。
