问题描述
在开发自定义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模板代码示例：
<?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>注意事项
- 端点名称一致性： 在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并加载对应页面的内容，从而提供无缝的用户体验。这种方法提供了一种灵活且健壮的解决方案，适用于需要精细控制分页逻辑的自定义场景。
