本文旨在解决在使用自定义 WP_Query 获取 WooCommerce 订单详情时遇到的 500 错误以及数据获取失败的问题。通过分析错误原因，提供了优化后的代码示例，并详细解释了如何正确地使用 WP_Query 来实现订单数据的分页加载和展示，避免常见的错误和陷阱。
在使用 WP_Query 获取 WooCommerce 订单详情时，可能会遇到一些问题，例如服务器返回 500 错误，或者查询结果为空。这些问题通常与查询参数设置不正确、循环使用方式不当，以及对 WooCommerce 对象的使用方式有关。下面将详细介绍如何解决这些问题，并提供一个可用的代码示例。
问题分析
- 500 错误： 500 错误通常表示服务器内部错误。在使用 WP_Query 时，如果在循环内部尝试获取订单 ID 或者订单项目时出现问题，可能是因为 $post 对象没有正确设置。
- 查询结果为空： 即使没有 500 错误，查询结果也可能为空。这可能是因为查询参数设置不正确，例如 post_type 或 post_status 设置错误，或者分页参数没有正确传递。
解决方案
1. 正确设置 WP_Query 参数
确保 WP_Query 的参数设置正确，特别是 post_type 和 post_status。对于 WooCommerce 订单，post_type 应该是 shop_order，post_status 应该是 wc-completed 或其他订单状态。此外，为了实现分页，需要正确设置 posts_per_page 和 paged 参数。
$paged = max( 1, intval( $_POST[ 'page' ] ) ); // 确保页码大于等于 1
$per_page = 4; // 每页显示的订单数量
$args = array(
'post_type' => 'shop_order',
'post_status' => 'wc-completed',
'orderby' => 'post_date',
'order' => 'DESC',
'posts_per_page' => $per_page,
'paged' => $paged,
);
$loop = new WP_Query( $args );2. 正确使用 the_post() 函数
在 WP_Query 的循环内部，必须调用 the_post() 函数来设置 $post 对象。这使得可以使用 get_the_ID() 函数获取当前订单的 ID。
if ( $loop->have_posts() ) {
while ( $loop->have_posts() ) {
$loop->the_post();
$order_id = get_the_ID(); // 正确获取订单 ID
$order = wc_get_order( $order_id ); // 使用订单 ID 获取 WC_Order 对象
// ... 其他代码 ...
}
wp_reset_postdata(); // 重置 $post 对象，避免影响其他查询
}3. 获取订单详情
获取订单详情需要使用 WC_Order 对象。通过 wc_get_order() 函数，可以使用订单 ID 获取 WC_Order 对象，然后使用该对象的方法来获取订单的各种信息，例如订单状态、订单项目、总金额等。
$order = wc_get_order( $order_id );
if ( $order ) {
$orders_id = $order->get_id(); // 获取订单 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(); // 获取格式化的订单总金额
$items = $order->get_items(); // 获取订单项目
foreach ( $items as $item ) {
$product_name = $item->get_name(); // 获取产品名称
$product_id = $item->get_product_id(); // 获取产品ID
$product = wc_get_product( $product_id ); // 获取产品对象
if($product){
$product_image = $product->get_image(); // 获取产品图片
}
// ... 其他代码 ...
}
}4. 完整代码示例
下面是一个完整的代码示例，展示了如何使用 WP_Query 获取 WooCommerce 订单详情，并进行分页显示：
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;
$msg = '';
if ( isset( $_POST[ 'page' ] ) ) {
$paged = max( 1, intval( $_POST[ 'page' ] ) );
$per_page = 4;
$args = array(
'post_type' => 'shop_order',
'post_status' => 'wc-completed',
'orderby' => 'post_date',
'order' => 'DESC',
'posts_per_page' => $per_page,
'paged' => $paged,
);
$loop = new WP_Query( $args );
$count = $loop->found_posts;
if ( $loop->have_posts() ) {
while ( $loop->have_posts() ) {
$loop->the_post();
$order_id = get_the_ID();
$order = wc_get_order( $order_id );
if ( $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' );
$payment_method = $order->get_payment_method_title();
$order_total = $order->get_formatted_order_total();
$items = $order->get_items();
foreach ( $items as $item ) {
$product_name = $item->get_name();
$product_id = $item->get_product_id();
$product = wc_get_product( $product_id );
if($product){
$product_image = $product->get_image();
}
$view_order = $order->get_view_order_url();
$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>
';
}
}
}
wp_reset_postdata();
}
$pages_num = intval( ceil( $count / $per_page ) );
$is_last_page = $pages_num == $paged;
$is_first_page = $paged === 1;
$pagination_html = "<div class='pagination-link'>";
$pagination_html .= "<ul>";
if ( !$is_first_page ) {
$pagination_html .= "<li data-pagenum='" . ( $paged - 1 ) . "' class='active'>Previous</li>";
} else {
$pagination_html .= "<li class='inactive'>Previous</li>";
}
for ( $i = 1; $i <= $pages_num; $i++ ) {
if ( $paged == $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='" . ( $paged + 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>' .
'<div class = "pagination-nav">' . $pagination_html . '</div>';
}
die();
}<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 ($) {
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);
$(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>5. 注意事项
- 安全性： 对 $_POST['page'] 进行严格的验证和过滤，防止 SQL 注入攻击。使用 intval() 函数将其转换为整数，并确保其值大于等于 1。
- 性能： 避免在循环内部执行复杂的数据库查询或计算，以提高性能。
- 错误处理： 添加适当的错误处理机制，例如检查 wc_get_order() 函数是否返回有效的 WC_Order 对象。
- 代码重用： 将代码封装成函数或类，以便在其他地方重用。
总结
通过正确设置 WP_Query 参数、使用 the_post() 函数、获取订单详情，并添加适当的错误处理机制，可以解决在使用自定义 WP_Query 获取 WooCommerce 订单详情时遇到的问题。以上提供的代码示例可以作为一个起点，根据实际需求进行修改和扩展。记住要始终关注代码的安全性、性能和可维护性。
