本文旨在解决在使用 WP_Query 自定义查询 WooCommerce 订单详情时遇到的 500 错误问题。通过分析问题代码，提供修复后的代码示例，并详细解释代码逻辑和注意事项，帮助开发者正确使用 WP_Query 获取和展示 WooCommerce 订单数据，实现分页加载等功能。本文还提供优化后的代码示例，使其更易于理解和维护。
在使用 WP_Query 获取 WooCommerce 订单详情时，经常会遇到一些问题，特别是当涉及到 AJAX 调用和分页功能时。 出现 500 错误通常是因为在循环内部使用了不正确的变量或方法来获取订单信息。以下将详细介绍如何正确地使用 WP_Query 来获取 WooCommerce 订单详情，并提供可行的解决方案。
问题分析
原始代码中存在几个问题：
- 错误的订单 ID 获取方式： 使用 $loop-youjiankuohaophpcnpost->ID 获取订单 ID 在 WP_Query 循环中是不正确的。应该使用 get_the_ID() 函数。
- 重复查询： 代码中使用了两个 WP_Query 实例，一个用于循环，另一个用于计数。这会导致不必要的性能开销。
- 分页逻辑复杂： 分页逻辑可以简化，使用 WP_Query 的 paged 参数可以更方便地实现分页。
- 代码可读性差： 代码结构可以优化，使其更易于理解和维护。
解决方案
以下是修复后的代码示例，它解决了上述问题并提供了更清晰的实现方式：
functions.php
<?php
add_action( 'wp_ajax_demo_pagination_posts', 'demo_pagination_posts' );
add_action( 'wp_ajax_nopriv_demo_pagination_posts', 'demo_pagination_posts' );
function demo_pagination_posts() {
global $wpdb;
if ( isset( $_POST['page'] ) ) {
// Sanitize and validate the page number
$page = max( intval( $_POST['page'] ), 1 );
$per_page = 4; // Number of orders per page
// WP_Query to retrieve shop orders with pagination
$args = array(
'post_type' => 'shop_order',
'post_status' => 'wc-completed',
'orderby' => 'post_date',
'order' => 'DESC',
'posts_per_page' => $per_page,
'paged' => $page, // Use the 'paged' parameter for pagination
);
$loop = new WP_Query( $args );
$count = $loop->found_posts; // Total number of posts found
$msg = '';
if ( $loop->have_posts() ) {
while ( $loop->have_posts() ) {
$loop->the_post();
// Get the order ID
$order_id = get_the_ID();
// Get an instance of the WC_Order Object
$order = wc_get_order( $order_id );
if ( $order ) {
$items = $order->get_items();
$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();
foreach ( $items as $item ) {
$product_name = $item->get_name();
$view_order = $order->get_view_order_url();
$product = $item->get_product();
if ( $product instanceof WC_Product ) {
$order_img = $product->get_image();
$downloads = $order->get_downloadable_items();
$download_button = '';
if ( is_array( $downloads ) ) {
foreach ( $downloads as $product ) {
$download_button = '<a href="' . $product['download_url'] . '" target="_blank">Download</a>';
}
}
$msg .= '
<table class="table_orders" border="2">
<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>
';
}
}
}
}
}
// Pagination logic
$pages_num = intval( ceil( $count / $per_page ) );
$is_last_page = $pages_num == $page;
$is_first_page = $page === 1;
$pagination_html = "<div class='pagination-link'>";
$pagination_html .= "<ul>";
if ( !$is_first_page ) {
$pagination_html .= "<li data-pagenum='" . ( $page - 1 ) . "' class='active'>Previous</li>";
} else {
$pagination_html .= "<li class='inactive'>Previous</li>";
}
// Display page numbers
$start_loop = max( 1, $page - 3 );
$end_loop = min( $pages_num, $page + 3 );
for ( $i = $start_loop; $i <= $end_loop; $i++ ) {
if ( $page == $i ) {
$pagination_html .= "<li data-pagenum='$i' class='selected'>{$i}</li>";
} else {
$pagination_html .= "<li data-pagenum='$i' class='active'>{$i}</li>";
}
}
if ( !$is_last_page ) {
$pagination_html .= "<li data-pagenum='" . ( $page + 1 ) . "' class='active'>Next</li>";
} else {
$pagination_html .= "<li class='inactive'>Next</li>";
}
$pagination_html .= "</ul>";
$pagination_html .= "</div>";
echo '<div class="pagination-content">' . $msg . '</div>';
echo '<div class="pagination-nav">' . $pagination_html . '</div>';
wp_reset_postdata(); // Reset the global post data
}
die();
}custom-template.php
<div class="wrap">
<div id="primary" class="content-area">
<div class="col-md-12 content">
<div class="inner-box content no-right-margin darkviolet">
<script type="text/javascript">
jQuery(document).ready(function ($) {
// This is required for AJAX to work on our page
var ajaxurl = '<?php echo admin_url( 'admin-ajax.php' ); ?>';
function load_all_posts(page) {
var data = {
page: page,
action: "demo_pagination_posts"
};
$.post(ajaxurl, data, function (response) {
$(".pagination_container").html(response);
});
}
load_all_posts(1); // Load page 1 as the default
$(document).on('click', '.pagination-link ul li', function () {
var page = $(this).attr('data-pagenum');
load_all_posts(page);
});
});
</script>
<div class="pag_loading">
<div class="pagination_container">
<div class="post-content"></div>
</div>
</div>
</div>
</div>
</div>
</div>代码解释
- 使用 get_the_ID() 获取订单 ID： 在 WP_Query 循环内部，使用 get_the_ID() 函数来获取当前订单的 ID。
- 使用 paged 参数进行分页： WP_Query 的 paged 参数用于指定当前页码，简化了分页逻辑。
- 简化分页逻辑： 分页逻辑被简化，使用 max() 和 min() 函数来确定循环的起始和结束页码。
- HTML 结构： HTML 结构被优化，使其更易于阅读和维护。
- 错误处理： 添加了对 $order 对象的判断，确保订单对象存在。
- 使用 wp_reset_postdata()： 在 WP_Query 循环之后，调用 wp_reset_postdata() 函数来恢复全局 $post 对象。
注意事项
- 确保你的 WooCommerce 版本是最新的，以避免潜在的兼容性问题。
- 在处理订单数据时，务必进行适当的验证和转义，以防止安全漏洞。
- 根据实际需求调整每页显示的订单数量。
- 优化 AJAX 请求，减少服务器负载。
- 使用浏览器的开发者工具来调试 AJAX 请求和响应。
总结
通过本文，你应该能够理解如何正确地使用 WP_Query 来获取 WooCommerce 订单详情，并实现分页加载等功能。 修复后的代码示例解决了原始代码中存在的问题，并提供了更清晰的实现方式。记住要遵循最佳实践，确保你的代码安全、高效和易于维护。
