本文旨在解决在使用自定义 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 = 'Download';
}
}
$msg .= '
| 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 |
";
$pagination_html .= "
";
echo '- ";
if ( !$is_first_page ) {
$pagination_html .= "
- Previous "; } else { $pagination_html .= "
- Previous "; } for ( $i = 1; $i <= $pages_num; $i++ ) { if ( $paged == $i ) { $pagination_html .= "
- {$i} "; } else { $pagination_html .= "
- {$i} "; } } if ( !$is_last_page ) { $pagination_html .= "
- Next "; } else { $pagination_html .= "
- Next "; } $pagination_html .= "
' . $msg . '
' .
'' . $pagination_html . '
';
}
die();
}5. 注意事项
- 安全性： 对 $_POST['page'] 进行严格的验证和过滤，防止 SQL 注入攻击。使用 intval() 函数将其转换为整数，并确保其值大于等于 1。
- 性能： 避免在循环内部执行复杂的数据库查询或计算，以提高性能。
- 错误处理： 添加适当的错误处理机制，例如检查 wc_get_order() 函数是否返回有效的 WC_Order 对象。
- 代码重用： 将代码封装成函数或类，以便在其他地方重用。
总结
通过正确设置 WP_Query 参数、使用 the_post() 函数、获取订单详情，并添加适当的错误处理机制，可以解决在使用自定义 WP_Query 获取 WooCommerce 订单详情时遇到的问题。以上提供的代码示例可以作为一个起点，根据实际需求进行修改和扩展。记住要始终关注代码的安全性、性能和可维护性。
